NAV Navbar
cURL PHP Java Node.js
  • Version
  • Introduction
  • Audience
  • Authentication
  • URLs
  • Transactions
  • Reconcile
  • Processed Transactions
  • Chargebacks
  • Retrieval Requests
  • Fraud reports
  • Blacklists
  • Asynchronous Transactions and Notifications
  • WPF
  • Authentication Services
  • Genesis KYC Services
  • Genesis Fx Services
  • Consumers
  • Tokenization
  • Transaction API
  • APM Services
  • Errors
  • Client Integrations
  • Client-side encryption
  • Shopping Carts
  • Testing
  • Status Page
  • Infrastructure and Uptime
  • Penetration Testing Warning
  • AVS Status Codes
  • Level 3 Travel Data
  • Genesis SCA Services

    • Version

    API version 15.7

    Documentation version 15.7

    History

    Version Date Name Description
    1.0 2011/06/10 Emil Petkov Initial version
    1.1 2011/11/11 Emil Petkov Added optional shipping params section for the shipping address
    1.2 2012/04/18 Emil Petkov Added dynamic descriptor functionality
    1.3 2012/08/03 Emil Petkov Added new transaction type AVS and Account Verification
    2.0 2013/03/29 Emil Petkov Added gaming and MOTO flags and support
    2.1 2013/04/11 Emil Petkov Split Credits with an initial ref transaction and Payouts without a reference transaction
    2.2 2013/05/26 Emil Petkov Added new transaction type InitRecurringSale3D - recurring payments with initial 3D
    2.3 2014/01/15 Emil Petkov Removed the transaction types DebitSale and IdealSale
    2.4 2014/01/22 Emil Petkov Added authorization code and issuer response code to API, section for issuer response codes
    2.5 2014/01/29 Emil Petkov Moto and gaming flags are now returned in the transaction response if present/marked in the request
    2.6 2014/02/05 Emil Petkov Dynamic descriptor params are now returned in the transaction response if present in the request
    2.7 2014/02/15 Emil Petkov Recurring advices are now returned in the transaction response if received from the issuer
    2.8 2014/05/01 Emil Petkov Added required vs. optional API params
    2.9 2014/06/16 Emil Petkov Currency handling rework and API description (different currency exponents, etc)
    3.0 2014/08/28 Emil Petkov Added risk related APIs - chargebacks, retrieval requests, blacklists
    3.1 2014/11/25 Emil Petkov Added API support for partial approvals
    3.2 2014/12/03 Emil Petkov Added WPF I18N specifics
    3.3 2014/12/08 Emil Petkov Added shopping carts and client integrations list
    3.4 2014/12/16 Hristo Tanchev Now the remote ip can be either a required or optional API param
    3.5 2015/02/22 Dimitar Kostov Added API for eZeeWallet and PayByVoucher via Yeepay
    3.6 2015/02/23 Hristo Tanchev Added API for CashU and Paysafecard
    3.7 2015/03/13 Dimitar Kostov Added API for Sofort
    3.8 2015/03/18 Hristo Tanchev Added API for PPRO
    3.9 2015/04/15 Emil Petkov New WPF API and WPF payment methods
    4.0 2015/05/14 Hristo Tanchev Added API for Neteller and ABN iDEAL
    4.1 2015/06/15 Dimitar Kostov Added WPF custom attributes - bin, tail
    4.2 2015/08/10 Tsvetelina Borisova Added WPF custom attributes - default, expiration date
    4.3 2015/08/12 Vladimir Korichkov Added API for WebMoney and POLi
    4.4 2015/08/19 Tsvetelina Borisova Added fraud related API for TC40/SAFE (fraud reports)
    4.5 2015/08/27 Emil Petkov 3D attributes xid and cavv are now not re- quired in the MPI sync attempted only workflow, only eci is
    4.6 2015/09/02 Emil Petkov New transaction type PayByVoucher Sale for purchasing vouchers via credit cards. Reworked the PayByVouchers section
    4.7 2015/09/04 Emil Petkov Added penetration testing warning for merchants
    4.8 2015/09/06 Emil Petkov Reconcile API now works with ARN and transaction ID in addition to unique ID
    4.9 2015/09/11 Hristo Tanchev Added Electronic Commerce Indicator to notifications
    5.0 2015/09/30 Vladimir Korichkov Added API for INPay
    5.1 2015/12/09 Pepa Simeonova Added event parameter to notifications for fraud transactions.
    5.2 2016/02/02 Hristo Tanchev Added API for P24
    5.3 2016/02/16 Tsvetelina Borisova Added ARN in reconcile response if available.
    5.4 2016/03/18 Tsvetelina Borisova Added page for Manually Reviewed Transactions
    5.5 2016/03/17 Tsvetelina Borisova Added API for SDD.
    5.6 2016/03/28 Emil Petkov Extended PayByVouchers processing and WPF APIs with redeem type and card type
    5.7 2016/04/08 Emil Petkov Added info for statuspage.io, uptime and infrastructure, and new shopping carts
    5.8 2016/05/11 Tsvetelina Borisova Change the example for chargeback API - amount is returned in minor currency unit
    5.9 2016/05/22 Emil Petkov Now birth date API param is required only for Visa initial transactions with Financial Service MCCs (e.g. 6012)
    6.0 2016/06/30 Pepa Simeonova Added dynamic descriptor params to WPF payments.
    6.1 2016/07/20 Stefan Slaveykov Now usage can be either a required or optional API param
    6.2 2016/07/21 Tsvetelina Borisova Update documentation for chargebacks API
    6.3 2016/12/08 George Naydenov Added API for Trustly
    6.4 2017/01/20 Plamen Terziev Added AVS Codes
    6.5 2017/02/16 Nikolay Petrov Added API for PayPal Express Checkout
    6.6 2017/03/20 Iskar Enev Added API for Citadel
    6.7 2017/03/30 Stanislav Mihailov Added API for Instadebit/iDebit
    6.8 2017/03/31 Tsvetelina Borisova Added API for SCT Payout
    6.9 2017/05/12 Nikolay Petrov Added reference transaction unique id to the Reconcile API response
    7.0 2017/05/13 Nikolay Petrov Added API for Earthport
    7.1 2017/05/15 Stanislav Mihailov Added API for Wechat
    7.2 2017/05/30 George Naydenov Added API for Alipay
    7.3 2017/06/05 Hristo Tanchev Added API for PaySec
    7.4 2017/06/06 Hristo Tenev Added card brand and card number tags in reconcile response.
    7.5 2017/06/27 Lukasz Wojcik Added lifetime for WPF Payments.
    7.6 2017/07/06 Nikolay Petrov Removed AVS transaction type. AVS response code and text are returned in the transactions responses when present and supported or in the notifications for payments with asynchronous workflow.
    7.7 2017/07/06 Iskar Enev Added APM External Events.
    7.8 2017/08/11 Samuil Goranov Added support for optional shipping address params in Processing and WPF APIs.
    7.9 2017/08/17 Lukasz Wojcik Remove remote ip parameter for transactions with reference. It will be copied from reference transaction
    8.0 2017/08/18 Lukasz Wojcik Added invalid transaction types for amount parameter to WPF response.
    8.1 2017/08/18 Emil Kirilov Added search option by import date in Chargeback, Retrieval request and Fraud APIs.
    8.2 2017/09/05 George Naydenov Added API for RPN Payment
    8.3 2017/10/13 Ventsislav Dimitrov Added API for FashionCheque gift card and split payments.
    8.4 2017/10/13 Pepa Simeonova Added API for Intersolve gift card and split payments.
    8.5 2017/10/13 Stanislav Mihailov Added API for TCS gift card and split payments.
    8.6 2017/10/23 Iskar Enev Added Authentication Services and iSignThis.
    8.7 2017/11/02 George Naydenov Added API for RPN Payout
    8.8 2017/11/24 Hristo Tenev Added API for Paycommerce
    8.9 2017/11/25 George Naydenov API update with new sections Card, 3DS Card, Common. Removing older payment methods.
    9.0 2017/12/18 George Naydenov Added API for Neosurf.
    9.1 2018/01/02 George Naydenov Removed API for Inpay, ABN iDeal, Teleingreso and PayByVoucher.
    9.2 2018/01/03 Iskar Enev & Nikolay Petrov Added Tokenization service.
    9.3 2018/01/12 Hristo Tanchev Added API for Klarna.
    9.4 2018/01/18 Stefan Petrov Added ARN in WPF reconcile response if available.
    9.5 2018/01/26 George Naydenov Added API for Astropay Direct, Pago Facil, Link, Carulla, Davivienda.
    9.6 2018/02/22 George Kostov & Hristo Tenev Added API for Genesis KYC Services.
    9.7 2018/02/22 Emil Kirilov Added API for PSE.
    9.8 2018/02/26 Stefan Petrov Added API for RapiPago, Webpay, Banco de Chile.
    9.9 2018/03/01 Stefan Petrov Added API for Surtimax, Efecty, Cabal, Cencosud, Hipercard, Elo, Aura, Itau, Bradesco, Tarjeta Shopping, BBVA Bancomer, Boleto, Redpagos, Emprese De Energia, GiroPay, InstantTransfer, Multibanco.
    10.0 2018/03/02 George Naydenov Added API for OXXO, Argencard, Naranja, Nativa, Cartao Mercado Livre, Astropay Card, Banamex, Santander, Santander Cash, Zimpler PayU.
    10.1 2018/03/02 Emil Kirilov Added API for Baloto, Banco de Occidente, Banco do Brasil.
    10.2 2018/04/10 Stefan Petrov Added API for Entercash.
    10.3 2018/05/08 Hristo Tenev Added API for eZeeWallet Payout.
    10.4 2018/05/31 Maya Nedyalkova Added 3D MasterCard test cards.
    10.5 2018/05/31 George Naydenov Added API for QQPay.
    10.6 2018/06/22 Hristo Tanchev Added API for Credential on File (COF).
    10.7 2018/07/05 George Naydenov Removed Paysec and added Online Banking OBeP.
    10.8 2018/07/18 Stanislav Mihailov Added the API param issuer_oct_enabled to Visa-based Account Verification transactions, to allow merchant to verify if issuer supports OCTs for the given PAN
    10.9 2018/07/27 Yordan Pulov Added Money Transfer support to Payouts.
    11.0 2018/08/01 George Naydenov Removed Paysec Payout and added Bank Payout.
    11.1 2018/08/02 Stanislav Mihailov Remove API for Citadel
    11.2 2018/08/31 Hristo Tenev Added API for BitPay.
    11.3 2018/08/31 Maya Nedyalkova Add rc_code and rc_description in notification parameters.
    11.4 2018/10/10 Ralitsa Borisova Remove Paycommerce, RPN Payment, Link, Davivienda, Banco de Chile, Cartao Mercado Livre documentation.
    11.5 2018/10/11 Emil Petkov Introduced debt repayments - now birth date API param is required also for Mastercard/- Maestro initial transactions with Financial Service MCCs (e.g. 6012), where merchant is UK-based, transaction is domestic (with UK-based bin), and card type is DEBIT.
    11.6 2018/11/02 Yordan Pulov and Stanislav Mihailov Introduced Travel layer and Added Level 3 Travel API.
    11.7 2018/11/21 Hristo Tenev Added Payout support for BitPay
    11.8 2018/12/05 Stefan Petrov Added API for eZeeCard Payout
    11.9 2018/12/05 Nikolay Petrov Added Pay Later support to the WPF. Introduced Reminders module.
    12.0 2019/01/07 Yordan Pulov Changed Contract Merchant Category Codes for Level 3 Visa Car and Hotel Rental Transactions.
    12.1 2019/01/31 Aleksandar Krastev Introduced Consumer API. Extended Tokenization API to require a consumer. Extended WPF and Processing APIs to create consumers and tokenize card details in one step. WPF API can use saved cards to make payments.
    12.2 2019/02/18 Yordan Pulov Extend the Online Banking bank codes and add payment type.
    12.3 2019/02/26 Stefan Petrov Added API for Tola payments.
    12.4 2019/03/13 Stanislav Mihailov Added support for new non-money transfer payout types.
    12.5 2019/03/19 Nikolay Valchanov Added cardholder and expiration dates params to reconcile APIs.
    12.6 2019/03/19 Vladislav Yakimov Added retrieve endpoint for the Consumer API.
    12.7 2019/03/22 Ventsislav Dimitrov Added support for Preauthorizations.
    12.8 2019/03/28 Nikolay Petrov Added support for importation of external tokens and card details.
    12.9 2019/04/01 Nikolay Petrov & Yasen Angelov Added support for Pay by Link functionality.
    13.0 2019/04/09 Hristo Tenev Added API for transaction card expiry date update.
    13.1 2019/04/11 Stanislav Mihailov Added API support for purchase of cryptocurrency transactions.
    13.2 2019/04/12 George Naydenov Removed QQPay transaction type.
    13.3 2019/04/15 Nikolay Valchanov Added usage and description params to WPF reconcile API.
    13.4 2019/04/22 Nikolay Valchanov Added optional bic param to iDeal transactions.
    13.5 2019/05/31 George Naydenov Added Genesis Fx Services.
    13.6 2019/06/07 Rumen Milushev Added WPF API Reconcile by_date.
    13.7 2019/06/14 Yordan Pulov Extended the Online Banking bank codes and Bank Payout banks.
    13.8 2019/07/02 Aleksandar Krastev Added Tokenization API get masked card details for token.
    13.9 2019/07/04 Vladislav Yakimov Added API for TransferTo Payout and TransferTo Payers retrieve.
    14.0 2019/07/09 Stefan Petrov Extend the Online Banking bank codes.
    14.1 2019/07/11 Pepa Simeonova Added new money-transfer types.
    14.2 2019/07/16 Hristo Tenev Added API support for Business attributes.
    14.3 2019/07/22 Pepa Simeonova Added source_of_funds as an optional API param for OCT types (Credit, Payout)
    14.4 2019/08/01 Stefan Petrov Removed API for Astropay Card, Astropay Direct, Hipercard, Carulla, Emprese de Energia, Surtimax.
    14.5 2019/08/05 Hristo Tanchev Extended Processing and WPF APIs support for FX (Forex).
    14.6 2019/08/05 Martin Lazarov Added reversible amount in Preauthorization reconcile response.
    14.7 2019/08/01 Rumen Milushev Added MOTO flag to WPF transaction types: Authorize, Authorize3D, Sale, Sale3D.
    14.8 2019/08/07 Yasen Angelov Added the new optional param reminder_language to the WPF API.
    14.9 2019/08/13 Stefan Petrov Rebranding African Mobile payments.
    15.0 2019/08/21 Nikolay Petrov Added new status 'represented' in notifications for Processing and WPF APIs.
    15.1 2019/08/22 Stefan Petrov Added beneficiary params to refund transaction.
    15.2 2019/09/03 Stefan Petrov Use sync workflow for Neosurf transaction.
    15.3 2019/09/13 Hristo Tanchev Extended transaction response with transaction ID form card schemes.
    15.4 2019/09/13 Yordan Pulov Added Genesis SCA Checker service API.
    15.5 2019/09/16 Nikolay Petrov Added support for Account Verification to the WPF API.
    15.6 2019/09/17 Ventsislav Dimitrov Extended the supported Merchant Category Codes for Visa Preauthorization
    15.7 2019/09/18 Aleksandar Krastev Added Processed Transaction API for Card Present and Card Not Present transactions.

    Introduction

    You can get PHP SDK from https://github.com/GenesisGateway/genesis_php

    Installation:
    Get the SDK from GitHub and load it with Composer autoloader or include it in your own autoloader (The SDK uses PSR-4 spec).

    git clone http://github.com/GenesisGateway/genesis_php genesis_php
    cd genesis_php
    composer install

    You can get Node.js SDK from https://github.com/GenesisGateway/genesis.js

    Installation:
    Get the SDK from GitHub

    git clone http://github.com/GenesisGateway/genesis.js genesis.js
    cd genesis.js
    npm install

    Or install it using npm

    npm install genesis.js

    You can get Java SDK from http://github.com/GenesisGateway/genesis_java

    Installation:
    Get the SDK from GitHub and install Maven plugin

    git clone http://github.com/GenesisGateway/genesis_java genesis_java
    cd genesis_java
    mvn clean install

    Finally add this to your pom.xml file:

    <dependency> <groupId>com.emerchantpay.gateway</groupId> <artifactId>genesis-java</artifactId> <version>1.3.1</version> </dependency>

    You can get cURL from https://curl.haxx.se

    This document describes the usage of the payment gateway XML/JSON API.

    The API allows you to trigger all supported transactions of the gateway and to retrieve information about transactions existing in the gateway. You can also retrieve chargeback information.

    The payment API is synchronous (except for 3-D secure payments), it accepts HTTP POST or XML data and returns XML data. Connections are always secured via SSL both in test and live mode. Be sure to set Content-type: text/xml in your headers.

    Audience

    This document is intended for technical staff integrating the XML/JSON API in the merchant’s organization.

    It is required that readers have working knowledge of programming languages, XML and JSON formats and UTF8 encodings.

    Authentication

    <?php

use \Genesis\Config as GenesisConfig;

// Load the pre-configured ini file...
GenesisConfig::loadSettings('/path/to/config.ini');

// ...OR, optionally, you can set the credentials manually
GenesisConfig::setEndpoint('<set_your_endpoint>');
GenesisConfig::setEnvironment('<set_your_environment>');
GenesisConfig::setUsername('<enter_your_username>');
GenesisConfig::setPassword('<enter_your_password>');
GenesisConfig::setToken('<enter_your_token>');

// You can find example configuration file in root directory of the module


    
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;;
import com.emerchantpay.gateway.util.Configuration;

// Create configuration
Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

configuration.setUsername("SET_YOUR_USERNAME");
configuration.setPassword("SET_YOUR_PASSWORD");
configuration.setToken("SET_YOUR_TOKEN");

    You can override the path to the directory holding your configuration files (by default its config in the root directory of the module) via environmental variable NODE_CONFIG_DIR.

    The first file to parse configuration from, is <your-config-dir>/default.json and based on the environment variable (NODE_ENV), you can specify your custom file; for example <your-config-dir>/<NODE_ENV_NAME>.json.

    Its good practice to prevent web/direct access to your config directory and protect the files inside

    Send username and password directly in url
    curl https://username:password@staging.gate.e-comprocessing.net:443/process/TERMINAL-TOKEN

    Or use -u flag
    curl -u username:password https://staging.gate.e-comprocessing.net:443/process/TERMINAL-TOKEN

    To interact with the payment API, you need to provide login credentials using standard HTTP Basic Authentication. (credentials can be found in your Admin interface.)

    To decrease network traffic and response times, we recommend that you enforce sending authentication credentials directly in the first request.

    Some implementations like e.g. the Java HTTPClient automatically try to guess the best authentication scheme. This can be overridden by setting the authorization to preemptive:

    URLs

    Server API

    API methods are called with the following structure:

    https://gate.e-comprocessing.net/process/TERMINAL_TOKEN/

    Single transaction reconciles can be done via this URL:

    https://gate.e-comprocessing.net/reconcile/TERMINAL_TOKEN/

    Date range reconciles can be done via this URL:

    https://gate.e-comprocessing.net/reconcile/by_date/TERMINAL_TOKEN/

    This URL allows retrieval of a list of supported banks based on the customers country and/or currency:

    https://gate.e-comprocessing.net/retrieve_inpay_banks/TERMINAL_TOKEN/

    For the test system use the following URLs:

    https://staging.gate.e-comprocessing.net/process/TERMINAL_TOKEN/

    https://staging.gate.e-comprocessing.net/reconcile/TERMINAL_TOKEN/

    https://staging.gate.e-comprocessing.net/reconcile/by_date/TERMINAL_TOKEN/

    https://staging.gate.e-comprocessing.net/retrieve_inpay_banks/TERMINAL_TOKEN/

    WPF

    The URL for the WPF API create method is:

    https://wpf.e-comprocessing.net/wpf

    For the test system the URL is:

    https://staging.wpf.e-comprocessing.net/wpf

    The URL for the WPF API reconcile method is:

    https://wpf.e-comprocessing.net/wpf/reconcile

    For the test system the URL is:

    https://staging.wpf.e-comprocessing.net/wpf/reconcile

    Your admin panel can be found here:

    https://merchant.e-comprocessing.net/

    Consumer API

    Create consumer:

    https://gate.e-comprocessing.net/v1/create_consumer/

    Retrieve consumer:

    https://gate.e-comprocessing.net/v1/retrieve_consumer/

    Update consumer:

    https://gate.e-comprocessing.net/v1/update_consumer/

    Disable consumer:

    https://gate.e-comprocessing.net/v1/disable_consumer/

    Enable consumer:

    https://gate.e-comprocessing.net/v1/enable_consumer/

    Get consumer cards:

    https://gate.e-comprocessing.net/v1/get_consumer_cards/

    For the test system use the following URLs:

    https://staging.gate.e-comprocessing.net/v1/create_consumer/

    https://staging.gate.e-comprocessing.net/v1/update_consumer/

    https://staging.gate.e-comprocessing.net/v1/disable_consumer/

    https://staging.gate.e-comprocessing.net/v1/enable_consumer/

    https://staging.gate.e-comprocessing.net/v1/get_consumer_cards/

    Tokenization API

    Tokenize cardholder data:

    https://gate.e-comprocessing.net/v1/tokenize/

    Detokenize cardholder data:

    https://gate.e-comprocessing.net/v1/detokenize/

    Update the cardholder data (PAN cannot be updated):

    https://gate.e-comprocessing.net/v1/update_token/

    Validate if given token is valid for the merchant:

    https://gate.e-comprocessing.net/v1/validate_token/

    Delete a token:

    https://gate.e-comprocessing.net/v1/delete_token/

    Exchange masked cardholder data for token:

    https://gate.e-comprocessing.net/v1/get_card/

    For the test system use the following URLs:

    https://staging.gate.e-comprocessing.net/v1/tokenize/

    https://staging.gate.e-comprocessing.net/v1/detokenize/

    https://staging.gate.e-comprocessing.net/v1/update_token/

    https://staging.gate.e-comprocessing.net/v1/validate_token/

    https://staging.gate.e-comprocessing.net/v1/delete_token/

    https://staging.gate.e-comprocessing.net/v1/get_card/

    Genesis KYC Services JSON API

    Testing environment

    Create Consumer:

    POST https://staging.gate.e-comprocessing.net/kyc_service/create_consumer

    Update Consumer:

    POST https://staging.gate.e-comprocessing.net/kyc_service/update_consumer

    Create Transaction:

    POST https://staging.gate.e-comprocessing.net/kyc_service/create_transaction

    Update Transaction:

    POST https://staging.gate.e-comprocessing.net/kyc_service/update_transaction

    Upload Document:

    POST https://staging.gate.e-comprocessing.net/kyc_service/upload_document

    Download Document:

    POST https://staging.gate.e-comprocessing.net/kyc_service/download_document

    Verify Phone:

    POST https://staging.gate.e-comprocessing.net/kyc_service/verify_phone

    Verify Identity:

    POST https://staging.gate.e-comprocessing.net/kyc_service/verify_identity

    Verify Bank Account:

    POST https://staging.gate.e-comprocessing.net/kyc_service/verify_bank_account

    Create Authentication:

    POST https://staging.gate.e-comprocessing.net/kyc_service/create_authentication

    Update Authentication:

    POST https://staging.gate.e-comprocessing.net/kyc_service/update_authentication

    Production environment

    Genesis KYC Services JSON API URLs for production environment:

    Create Consumer:

    POST https://gate.e-comprocessing.net/kyc_service/create_consumer

    Update Consumer:

    POST https://gate.e-comprocessing.net/kyc_service/update_consumer

    Create Transaction:

    POST https://gate.e-comprocessing.net/kyc_service/create_transaction

    Update Transaction:

    POST https://gate.e-comprocessing.net/kyc_service/update_transaction

    Upload Document:

    POST https://gate.e-comprocessing.net/kyc_service/upload_document

    Download Document:

    POST https://gate.e-comprocessing.net/kyc_service/download_document

    Verify Phone:

    POST https://gate.e-comprocessing.net/kyc_service/verify_phone

    Verify Identity:

    POST https://gate.e-comprocessing.net/kyc_service/verify_identity

    Verify Bank Account:

    POST https://gate.e-comprocessing.net/kyc_service/verify_bank_account

    Create Authentication:

    POST https://gate.e-comprocessing.net/kyc_service/create_authentication

    Update Authentication:

    POST https://gate.e-comprocessing.net/kyc_service/update_authentication

    Transaction API

    Update expiration date:

    PUT https://gate.e-comprocessing.net/v1/transaction/expiry_date/:transaction_unique_id

    For the test system use the following URLs:

    PUT https://staging.gate.e-comprocessing.net/v1/transaction/expiry_date/:transaction_unique_id

    Transactions

    Invoking a Transaction

    A transaction is invoked via HTTPS POST, parameters are passed as XML with UTF-8 encoding.

    Card

    Recurring Transactions

    A recurring transaction describes a payment where the cardholder’s account is periodically charged for a repeated delivery and use of a product or service (subscription, membership fee, etc.) over time. A recurring payment consists of an initial transaction and one or several repeated transactions. The ”initial” transaction contains all relevant card and cardholder data, while the subsequent repeated transaction references an identifier which is returned with the response to the initial request.

    Init Recurring Sale

    An InitRecurringSale transaction initializes a recurring payment and is equal to a normal SaleTransaction except that it can be referenced as ”initial” transaction in a RecurringSale transaction.

    Note that if an InitRecurringSale is fully refunded, the recurring series is stopped and no more RecurringSales can be performed for that recurring series.

    If an InitRecurringSale is partially refunded, the recurring series can continue with more RecurringSales

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Recurring\InitRecurringSale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.recurring.InitRecurringSale;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    InitRecurringSale request = new InitRecurringSale();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.init_recurring_sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "business_attributes": {
      "event_start_date": "18-10-2019",
      "event_end_date": "28-10-2019",
      "event_organizer_id": "20192375",
      "event_id": "1912"
    },
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>init_recurring_sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <business_attributes>
      <event_start_date>18-10-2019</event_start_date>
      <event_end_date>28-10-2019</event_end_date>
      <event_organizer_id>20192375</event_organizer_id>
      <event_id>1912</event_id>
    </business_attributes>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: init_recurring_sale
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_holder required string(255) Full name of customer as printed on credit card (first name and last name at least)
    card_number required 13 to 16 digits Complete cc number of customer
    cvv required* 3 to 4 digits cvv of cc, requirement is based on terminal configuration
    expiration_month required MM Expiration month as printed on credit card
    expiration_year required YYYY Expiration year as printed on credit card
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted. Cannot be set together with remember_card
    remember_card optional "true" See Tokenize. Tokenizes cardholder parameters. Cannot be set together with token
    consumer_id optional string(10) See Consumers and Tokenization. Combine with remember_card to tokenize or with token to use token
    credential_on_file required* See Credential On File (COF) for more details
       initial_customer_initiated required* string(18) Initial transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       subsequent_customer_initiated required* string(18) Subsequent transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       merchant_unscheduled optional string(20) Transaction is initiated by the merchant
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    birth_date required* dd-mm-yyyy Required when MCC is a Financial Services one (e.g. MCC 6012) and either card brand is Visa or Mastercard/Maestro with UK-based merchant, UK-based bin (domestic), and DEBIT card type
    document_id required* sring(20) Document ID of the consumer. See Document ID Parameter for more details.
    fx_rate_id optional integer See Get rates for FX Service. Offers the option to use a specific FX rate to convert the transaction processing amount. Used FX rate should have the same source currency as the processing currency. Contact tech-support@e-comprocessing.com for more details.
    business_attributes required* Check business attributes section.
       event_start_date required* dd-mm-yyyy The date when event starts in format dd-mm-yyyy
       event_end_date required* dd-mm-yyyy The date when event ends in format dd-mm-yyyy
       event_organizer_id required* string
       event_id required* string
       date_of_order required* dd-mm-yyyy The date when order was placed in format dd-mm-yyyy
       delivery_date required* dd-mm-yyyy Date of the expected delivery in format dd-mm-yyyy
       name_of_the_supplier required* string
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => init_recurring_sale
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 345678
    [response_code] => 00
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:58.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[init_recurring_sale]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:38:58Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "init_recurring_sale",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "345678",
    response_code: "00",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:38:58Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>init_recurring_sale</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:38:58Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    consumer_id string(10) Consumer unique reference. See Consumers
    token string(36) Plain-text token value. See Tokenization
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    recurring_advice_code string(2) Optional, if received in the response from the issuer
    recurring_advice_text string Optional, describes the specific recurring advice code
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    partial_approval string(4) Optional, set to ’true’ if partial approval happened. Partially approved amount is then in the amount field. Check Partial Approvals for details
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.
    scheme_transaction_identifier string(32) Id defined by card schemes

    Error Response

    stdClass Object
(
    [transaction_type] => init_recurring_sale
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 57
    [code] => 340
    [message] => billing_address[zip_code] is invalid!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[init_recurring_sale]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <response_code content=[57]>
    <code content=[340]>
    <message content=[billing_address[zip_code] is invalid!]>
    <timestamp content=[2019-09-17T15:38:59Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "init_recurring_sale",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    response_code: "57",
    code: "340",
    message: "billing_address[zip_code] is invalid!",
    timestamp: "2019-09-17T15:38:59Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>init_recurring_sale</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code>57</response_code>
    <code>340</code>
    <message>billing_address[zip_code] is invalid!</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Recurring Sale

    A RecurringSale transaction is a ”repeated” transaction which follows and references a Init Recurring Sale transaction.

    The card and cardholder data is omitted. Note that RecurringSales can be partially or fully refunded if configuration allows it, and this will not stop the recurring series.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Recurring\RecurringSale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReferenceId('43672')
  ->setAmount('100')
  ->setCurrency('USD');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.recurring.RecurringSale;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    RecurringSale request = new RecurringSale();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReferenceId("43672");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.recurring_sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "reference_id": "43672",
    "amount": "100",
    "currency": "USD",
    "business_attributes": {
      "event_start_date": "18-10-2019",
      "event_end_date": "28-10-2019",
      "event_organizer_id": "20192375",
      "event_id": "1912"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>recurring_sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>43672</reference_id>
    <amount>100</amount>
    <currency>USD</currency>
    <business_attributes>
      <event_start_date>18-10-2019</event_start_date>
      <event_end_date>28-10-2019</event_end_date>
      <event_organizer_id>20192375</event_organizer_id>
      <event_id>1912</event_id>
    </business_attributes>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: recurring_sale
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    gaming optional "true" Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required string(32) Unique id returned by corresponding transaction
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    business_attributes required* Check business attributes section.
       event_start_date required* dd-mm-yyyy The date when event starts in format dd-mm-yyyy
       event_end_date required* dd-mm-yyyy The date when event ends in format dd-mm-yyyy
       event_organizer_id required* string
       event_id required* string
       date_of_order required* dd-mm-yyyy The date when order was placed in format dd-mm-yyyy
       delivery_date required* dd-mm-yyyy Date of the expected delivery in format dd-mm-yyyy
       name_of_the_supplier required* string

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => recurring_sale
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [authorization_code] => 345678
    [response_code] => 00
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[recurring_sale]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:38:59Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "recurring_sale",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    authorization_code: "345678",
    response_code: "00",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:38:59Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>recurring_sale</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    recurring_advice_code string(2) Optional, if received in the response from the issuer
    recurring_advice_text string Optional, describes the specific recurring advice code
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => recurring_sale
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 57
    [code] => 340
    [message] => billing_address[zip_code] is invalid!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[recurring_sale]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <response_code content=[57]>
    <code content=[340]>
    <message content=[billing_address[zip_code] is invalid!]>
    <timestamp content=[2019-09-17T15:38:59Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "recurring_sale",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    response_code: "57",
    code: "340",
    message: "billing_address[zip_code] is invalid!",
    timestamp: "2019-09-17T15:38:59Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>recurring_sale</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code>57</response_code>
    <code>340</code>
    <message>billing_address[zip_code] is invalid!</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Authorize

    With authorize transactions, you can confirm that a credit card is valid and reserve the desired amount on the card.

    After settling the transaction (e.g. shipping the goods), you can then capture the amount. The customer will not be billed until the capture has taken place, but the amount is reserved and the customer’s credit card limit is reduced. Authorizes will automatically be cancelled after a certain timeframe, most likely one week.

    For a typical e-commerce application it is recommended to authorize the amount on incoming orders and capture it when shipping the goods. If you are selling services or non-tangible goods, you can use the sale transaction, which combines authorize and capture.

    If you choose not to serve the customer, consider to void the authorize to unfreeze the amount on the client’s credit card.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Authorize');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.AuthorizeRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    AuthorizeRequest request = new AuthorizeRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.authorize(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "business_attributes": {
      "event_start_date": "18-10-2019",
      "event_end_date": "28-10-2019",
      "event_organizer_id": "20192375",
      "event_id": "1912"
    },
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <business_attributes>
      <event_start_date>18-10-2019</event_start_date>
      <event_end_date>28-10-2019</event_end_date>
      <event_organizer_id>20192375</event_organizer_id>
      <event_id>1912</event_id>
    </business_attributes>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: authorize
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    gaming optional "true" Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    crypto optional "true" Signifies whether a purchase of cryptocurrency transaction is performed. Must be populated when purchasing cryptocurrency with a VISA card and MCC 6051. In this case, the gaming flag must be sent too. Contact tech-support@e-comprocessing.com for more details.
    preauthorization optional "true" Signifies whether a preauthorization transaction is performed. Check the Preauthorizations section or contact tech support for more details.
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_holder required string(255) Full name of customer as printed on credit card (first name and last name at least)
    card_number required 13 to 16 digits Complete cc number of customer
    cvv required* 3 to 4 digits cvv of cc, requirement is based on terminal configuration
    expiration_month required MM Expiration month as printed on credit card
    expiration_year required YYYY Expiration year as printed on credit card
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted. Cannot be set together with remember_card
    remember_card optional "true" See Tokenize. Tokenizes cardholder parameters. Cannot be set together with token
    consumer_id optional string(10) See Consumers and Tokenization. Combine with remember_card to tokenize or with token to use token
    credential_on_file required* See Credential On File (COF) for more details
       initial_customer_initiated required* string(18) Initial transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       subsequent_customer_initiated required* string(18) Subsequent transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       merchant_unscheduled optional string(20) Transaction is initiated by the merchant
    credential_on_file_transaction_identifier optional string(15..32) See Credential On File (COF) for more details
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    birth_date required* dd-mm-yyyy Required when MCC is a Financial Services one (e.g. MCC 6012) and either card brand is Visa or Mastercard/Maestro with UK-based merchant, UK-based bin (domestic), and DEBIT card type
    document_id required* sring(20) Document ID of the consumer. See Document ID Parameter for more details.
    fx_rate_id optional integer See Get rates for FX Service. Offers the option to use a specific FX rate to convert the transaction processing amount. Used FX rate should have the same source currency as the processing currency. Contact tech-support@e-comprocessing.com for more details.
    business_attributes required* Check business attributes section.
       event_start_date required* dd-mm-yyyy The date when event starts in format dd-mm-yyyy
       event_end_date required* dd-mm-yyyy The date when event ends in format dd-mm-yyyy
       event_organizer_id required* string
       event_id required* string
       date_of_order required* dd-mm-yyyy The date when order was placed in format dd-mm-yyyy
       delivery_date required* dd-mm-yyyy Date of the expected delivery in format dd-mm-yyyy
       name_of_the_supplier required* string
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 345678
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <timestamp content=[2019-09-17T15:38:59Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "345678",
    response_code: "00",
    timestamp: "2019-09-17T15:38:59Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    consumer_id string(10) Consumer unique reference. See Consumers
    token string(36) Plain-text token value. See Tokenization
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    partial_approval string(4) Optional, set to ’true’ if partial approval happened. Partially approved amount is then in the amount field. Check Partial Approvals for details
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.
    scheme_transaction_identifier string(32) Id defined by card schemes

    Error Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => expiration_year is invalid
    [message] => expiration_year is invalid
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[expiration_year is invalid]>
    <message content=[expiration_year is invalid]>
    <timestamp content=[2019-09-17T15:38:59Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "authorize",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "340",
    technical_message: "expiration_year is invalid",
    message: "expiration_year is invalid",
    timestamp: "2019-09-17T15:38:59Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>expiration_year is invalid</technical_message>
    <message>expiration_year is invalid</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Capture

    Capture settles a transaction which has been authorized before.

    Do this when you are shipping goods, for example. A capture can only be used after an authorize on the same transaction and on the same terminal.

    Therefore, the reference id of the authorized transaction is mandatory.

    Transaction workflow:

    1. The merchant sends authorize transaction to the gateway.
    2. The gateway replies to it. One of returned values is the unique id of the transaction.
    3. The merchant sends capture transaction. Its reference id is unique id of authorize response.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Capture');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReferenceId('43672')
  ->setAmount('100')
  ->setCurrency('USD');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.CaptureRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    CaptureRequest request = new CaptureRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReferenceId("43672");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.capture(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "reference_id": "43672",
    "amount": "100",
    "currency": "USD",
    "business_attributes": {
      "event_start_date": "18-10-2019",
      "event_end_date": "28-10-2019",
      "event_organizer_id": "20192375",
      "event_id": "1912"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>capture</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>43672</reference_id>
    <amount>100</amount>
    <currency>USD</currency>
    <business_attributes>
      <event_start_date>18-10-2019</event_start_date>
      <event_end_date>28-10-2019</event_end_date>
      <event_organizer_id>20192375</event_organizer_id>
      <event_id>1912</event_id>
    </business_attributes>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: capture
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required string(32) Unique id returned by corresponding transaction
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    business_attributes required* Check business attributes section.
       event_start_date required* dd-mm-yyyy The date when event starts in format dd-mm-yyyy
       event_end_date required* dd-mm-yyyy The date when event ends in format dd-mm-yyyy
       event_organizer_id required* string
       event_id required* string
       date_of_order required* dd-mm-yyyy The date when order was placed in format dd-mm-yyyy
       delivery_date required* dd-mm-yyyy Date of the expected delivery in format dd-mm-yyyy
       name_of_the_supplier required* string

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => capture
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [authorization_code] => 345678
    [response_code] => 00
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[capture]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:38:59Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "capture",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    authorization_code: "345678",
    response_code: "00",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:38:59Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>capture</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => capture
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 430
    [technical_message] => Reference transaction has already been captured, and acquirer does not support partial/multiple capture
    [message] => Transaction declined.
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[capture]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[430]>
    <technical_message content=[Reference transaction has already been captured, and acquirer does not support partial/multiple capture]>
    <message content=[Transaction declined.]>
    <timestamp content=[2019-09-17T15:38:59Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "capture",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "430",
    technical_message: "Reference transaction has already been captured, and acquirer does not support partial/multiple capture",
    message: "Transaction declined.",
    timestamp: "2019-09-17T15:38:59Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>capture</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>430</code>
    <technical_message>Reference transaction has already been captured, and acquirer does not support partial/multiple capture</technical_message>
    <message>Transaction declined.</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Sale

    Sale transactions combine authorize and capture into one step.

    Using a sale transaction, the amount is immediately billed to the customer’s credit card. It can be reversed via a void transaction on the same day of the transaction. Use sale transactions, if you are e.g. selling non-tangible goods or services.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "business_attributes": {
      "event_start_date": "18-10-2019",
      "event_end_date": "28-10-2019",
      "event_organizer_id": "20192375",
      "event_id": "1912"
    },
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <business_attributes>
      <event_start_date>18-10-2019</event_start_date>
      <event_end_date>28-10-2019</event_end_date>
      <event_organizer_id>20192375</event_organizer_id>
      <event_id>1912</event_id>
    </business_attributes>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: sale
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    gaming optional "true" Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    crypto optional "true" Signifies whether a purchase of cryptocurrency transaction is performed. Must be populated when purchasing cryptocurrency with a VISA card and MCC 6051. In this case, the gaming flag must be sent too. Contact tech-support@e-comprocessing.com for more details.
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_holder required string(255) Full name of customer as printed on credit card (first name and last name at least)
    card_number required 13 to 16 digits Complete cc number of customer
    cvv required* 3 to 4 digits cvv of cc, requirement is based on terminal configuration
    expiration_month required MM Expiration month as printed on credit card
    expiration_year required YYYY Expiration year as printed on credit card
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted. Cannot be set together with remember_card
    remember_card optional "true" See Tokenize. Tokenizes cardholder parameters. Cannot be set together with token
    consumer_id optional string(10) See Consumers and Tokenization. Combine with remember_card to tokenize or with token to use token
    credential_on_file required* See Credential On File (COF) for more details
       initial_customer_initiated required* string(18) Initial transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       subsequent_customer_initiated required* string(18) Subsequent transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       merchant_unscheduled optional string(20) Transaction is initiated by the merchant
    credential_on_file_transaction_identifier optional string(15..32) See Credential On File (COF) for more details
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    birth_date required* dd-mm-yyyy Required when MCC is a Financial Services one (e.g. MCC 6012) and either card brand is Visa or Mastercard/Maestro with UK-based merchant, UK-based bin (domestic), and DEBIT card type
    document_id required* sring(20) Document ID of the consumer. See Document ID Parameter for more details.
    fx_rate_id optional integer See Get rates for FX Service. Offers the option to use a specific FX rate to convert the transaction processing amount. Used FX rate should have the same source currency as the processing currency. Contact tech-support@e-comprocessing.com for more details.
    business_attributes required* Check business attributes section.
       event_start_date required* dd-mm-yyyy The date when event starts in format dd-mm-yyyy
       event_end_date required* dd-mm-yyyy The date when event ends in format dd-mm-yyyy
       event_organizer_id required* string
       event_id required* string
       date_of_order required* dd-mm-yyyy The date when order was placed in format dd-mm-yyyy
       delivery_date required* dd-mm-yyyy Date of the expected delivery in format dd-mm-yyyy
       name_of_the_supplier required* string
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => sale
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 345678
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[sale]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <timestamp content=[2019-09-17T15:38:59Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "sale",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "345678",
    response_code: "00",
    timestamp: "2019-09-17T15:38:59Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    consumer_id string(10) Consumer unique reference. See Consumers
    token string(36) Plain-text token value. See Tokenization
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    partial_approval string(4) Optional, set to ’true’ if partial approval happened. Partially approved amount is then in the amount field. Check Partial Approvals for details
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.
    scheme_transaction_identifier string(32) Id defined by card schemes

    Error Response

    stdClass Object
(
    [transaction_type] => sale
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 57
    [code] => 340
    [technical_message] => billing_address[zip_code] is invalid!
    [message] => billing_address[zip_code] is invalid!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[sale]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <response_code content=[57]>
    <code content=[340]>
    <technical_message content=[billing_address[zip_code] is invalid!]>
    <message content=[billing_address[zip_code] is invalid!]>
    <timestamp content=[2019-09-17T15:38:59Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "sale",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    response_code: "57",
    code: "340",
    technical_message: "billing_address[zip_code] is invalid!",
    message: "billing_address[zip_code] is invalid!",
    timestamp: "2019-09-17T15:38:59Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code>57</response_code>
    <code>340</code>
    <technical_message>billing_address[zip_code] is invalid!</technical_message>
    <message>billing_address[zip_code] is invalid!</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Argencard

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Argencard');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rumble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('barney@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Buenos Aires')
  ->setBillingCountry('AR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>argencard</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>barney@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Buenos Aires</city>
      <country>AR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: argencard
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National Identifier number of the customer
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    AR

    Successful Response

    stdClass Object
(
    [transaction_type] => argencard
    [status] => pending_async
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>argencard</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => argencard
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>argencard</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Aura

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Aura');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rumble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('barney@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Salvador')
  ->setBillingCountry('BR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>aura</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>barney@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Salvador</city>
      <country>BR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: aura
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National Identifier number of the customer
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    BR

    Successful Response

    stdClass Object
(
    [transaction_type] => aura
    [status] => pending_async
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>aura</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => aura
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>aura</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Bancontact

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bcmc</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>12114</zip_code>
      <city>Brussels</city>
      <country>BE</country>
    </billing_address>
  </payment_transaction>'

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\PPRO');
$request = $genesis->request();

$request
  ->setPaymentType('bcmc')
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('12114')
  ->setBillingCity('Brussels')
  ->setBillingCountry('BE');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.PProRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PProRequest request = new PProRequest();

    request.setPaymentType("bcmc");
    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("12114");
    request.setBillingCity("Brussels");
    request.setBillingCountry("BE");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.ppro(
  {
    "payment_type": "bcmc",
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "EUR",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "12114",
      "city": "Brussels",
      "country": "BE"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <payment_type>bcmc</payment_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>12114</zip_code>
      <city>Brussels</city>
      <country>BE</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) ppro or bcmc. Contact tech support at tech-support@e-comprocessing.com for more details.
    payment_type required* bcmc Bancontact Mr. Cash. Contact tech support for more details
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported currencies and countries:

    Currency code Country code
    EUR BE

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bcmc</transaction_type>
    <status>pending_async</status>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <transaction_id>43671</transaction_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <mode>live</mode>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => pending_async
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [transaction_id] => 43671
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [mode] => live
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[pending_async]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <transaction_id content=[43671]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <mode content=[live]>
    <timestamp content=[2019-09-17T15:38:59Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "pending_async",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    transaction_id: "43671",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    mode: "live",
    timestamp: "2019-09-17T15:38:59Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>pending_async</status>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <transaction_id>43671</transaction_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <mode>live</mode>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    transaction_id string(255) Unique transaction id defined by merchant
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bcmc</transaction_type>
    <status>error</status>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <transaction_id>43671</transaction_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => error
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [transaction_id] => 43671
    [code] => 110
    [technical_message] => 
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[error]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <transaction_id content=[43671]>
    <code content=[110]>
    <technical_message content=[]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:38:59Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "ppro",
    status: "error",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    transaction_id: "43671",
    code: "110",
    technical_message: "",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:38:59Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>error</status>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <transaction_id>43671</transaction_id>
    <code>110</code>
    <technical_message nil="true"/>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    transaction_id string(255) Unique transaction id defined by merchant
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Cabal

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Cabal');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('braney_rubble')
  ->setNationalId('8812128812')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>cabal</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>braney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: cabal
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National Identifier number of the customer
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries

    Country Name Country Code
    Argentina AR

    Successful Response

    stdClass Object
(
    [status] => pending_async
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [transaction_id] => 43671
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61d0
    [mode] => live
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <status>pending_async</status>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <transaction_id>43671</transaction_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61d0</redirect_url>
    <mode>live</mode>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the transaction, see states
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    transaction_id string(255) Unique transaction id defined by merchant
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [status] => error
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [transaction_id] => 43671
    [code] => 110
    [message] => Something went wrong, please contact support!
    [mode] => live
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:38:59.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <status>error</status>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <transaction_id>43671</transaction_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <mode>live</mode>
    <timestamp>2019-09-17T15:38:59Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    status string Status of the transaction, see states
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    transaction_id string(255) Unique transaction id defined by merchant
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Cencosud

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Cencosud');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rumble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('barney@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Buenos Aires')
  ->setBillingCountry('AR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>cencosud</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>barney@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Buenos Aires</city>
      <country>AR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: cencosud
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National Identifier number of the customer
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    AR

    Successful Response

    stdClass Object
(
    [transaction_type] => cencosud
    [status] => pending_async
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>cencosud</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => cencosud
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>cencosud</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Credit (CFT)

    Credits (also known as Credit Fund Transfer a.k.a. CFT) can be done with an initial reference transaction.

    This transaction type allows you to transfer funds to a previously charged card. The amount can be higher than the charged reference. Credits can only be done on former sale, sale3d, init recurring sale, init recurring sale3d, recurring sale or capture transaction. Therefore, the reference_id for the corresponding transaction is mandatory.

    Note that Visa credits are not authorized through the schemes but batched for offline settlement on the same day, while Mastercard/Maestro credits are authorized real-time. This means that the authorization code and issuer response code are available only for non-Visa credits.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Credit');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setReferenceId('43672')
  ->setAmount('100');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.CreditRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    CreditRequest request = new CreditRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setReferenceId("43672");
    request.setAmount(new BigDecimal(100));

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.credit(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "reference_id": "43672",
    "amount": "100"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>credit</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <reference_id>43672</reference_id>
    <amount>100</amount>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: credit
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    reference_id required string(32) Unique id returned by corresponding transaction
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => credit
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [authorization_code] => 345678
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
)

    <payment_response content=[
    <transaction_type content=[credit]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <timestamp content=[2019-09-17T15:39:00Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
]>

    {
    transaction_type: "credit",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    authorization_code: "345678",
    response_code: "00",
    timestamp: "2019-09-17T15:39:00Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>credit</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Error Response

    stdClass Object
(
    [transaction_type] => credit
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 57
    [code] => 410
    [technical_message] => No approved reference transaction found
    [message] => No approved reference transaction found
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
)

    <payment_response content=[
    <transaction_type content=[credit]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <response_code content=[57]>
    <code content=[410]>
    <technical_message content=[No approved reference transaction found]>
    <message content=[No approved reference transaction found]>
    <timestamp content=[2019-09-17T15:39:00Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
]>

    {
    transaction_type: "credit",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    response_code: "57",
    code: "410",
    technical_message: "No approved reference transaction found",
    message: "No approved reference transaction found",
    timestamp: "2019-09-17T15:39:00Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>credit</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code>57</response_code>
    <code>410</code>
    <technical_message>No approved reference transaction found</technical_message>
    <message>No approved reference transaction found</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Elo

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Elo');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rumble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('barney@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Salvador')
  ->setBillingCountry('BR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>elo</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>barney@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Salvador</city>
      <country>BR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: elo
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National Identifier number of the customer
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    BR

    Successful Response

    stdClass Object
(
    [transaction_type] => elo
    [status] => pending_async
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>elo</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => elo
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>elo</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Naranja

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Naranja');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rumble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('barney@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Buenos Aires')
  ->setBillingCountry('AR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>naranja</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>barney@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Buenos Aires</city>
      <country>AR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: naranja
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National Identifier number of the customer
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    AR

    Successful Response

    stdClass Object
(
    [transaction_type] => naranja
    [status] => pending_async
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>naranja</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => naranja
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>naranja</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Nativa

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Nativa');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rumble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('barney@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Buenos Aires')
  ->setBillingCountry('AR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>nativa</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>barney@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Buenos Aires</city>
      <country>AR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: nativa
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National Identifier number of the customer
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    AR

    Successful Response

    stdClass Object
(
    [transaction_type] => nativa
    [status] => pending_async
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>nativa</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => nativa
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>nativa</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Tarjeta Shopping

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\TarjetaShopping');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rubble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Rosario')
  ->setBillingCountry('AR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>tarjeta_shopping</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Rosario</city>
      <country>AR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: tarjeta_shopping
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National Identifier number of the customer
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    AR

    Successful Response

    stdClass Object
(
    [transaction_type] => tarjeta_shopping
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>tarjeta_shopping</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => tarjeta_shopping
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>tarjeta_shopping</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Non-financial Transactions

    Account Verification

    Account Verification transactions are implemented using the so-called zero-value auths.

    Using an account verification transaction, the account existence for a given cardholder can be verified without any financial impact.

    Note the account verification can also carry on an AVS request, thus you can also get the AVS response code and text by the schemes along with it. Refer to section AVS Status Codes for more information.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\AccountVerification');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.AccountVerificationRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    AccountVerificationRequest request = new AccountVerificationRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.account_verification(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>account_verification</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Example When Issuer Supports Oct For This Pan:

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\AccountVerification');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setIssuerOctEnabled('true')
  ->setRemoteIp('245.253.2.12')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.AccountVerificationRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    AccountVerificationRequest request = new AccountVerificationRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setIssuerOctEnabled("true");
    request.setRemoteIp("245.253.2.12");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.account_verification(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "issuer_oct_enabled": true,
    "remote_ip": "245.253.2.12",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>account_verification</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <issuer_oct_enabled>true</issuer_oct_enabled>
    <remote_ip>245.253.2.12</remote_ip>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: account_verification
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    issuer_oct_enabled optional true Supported only by Visa. When submitted, Visa checks if the given PAN supports OCTs at the issuer. When not submitted, it is interpreted as a normal account verification.
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    card_holder required string(255) Full name of customer as printed on credit card (first name and last name at least)
    card_number required 13 to 16 digits Complete cc number of customer
    cvv required* 3 to 4 digits cvv of cc, requirement is based on terminal configuration
    expiration_month required MM Expiration month as printed on credit card
    expiration_year required YYYY Expiration year as printed on credit card
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted. Cannot be set together with remember_card
    remember_card optional "true" See Tokenize. Tokenizes cardholder parameters. Cannot be set together with token
    consumer_id optional string(10) See Consumers and Tokenization. Combine with remember_card to tokenize or with token to use token
    credential_on_file required* See Credential On File (COF) for more details
       initial_customer_initiated required* string(18) Initial transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       subsequent_customer_initiated required* string(18) Subsequent transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       merchant_unscheduled optional string(20) Transaction is initiated by the merchant
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    document_id required* sring(20) Document ID of the consumer. See Document ID Parameter for more details.
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => account_verification
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 345678
    [response_code] => 00
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [sent_to_acquirer] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[account_verification]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:00Z]>
    <descriptor content=[Descriptor one]>
    <sent_to_acquirer content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "account_verification",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "345678",
    response_code: "00",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:00Z",
    descriptor: "Descriptor one",
    sent_to_acquirer: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>account_verification</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <sent_to_acquirer>true</sent_to_acquirer>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Example When Issuer Supports Oct For This Pan:

    Successful Response

    stdClass Object
(
    [transaction_type] => account_verification
    [status] => approved
    [issuer_oct_enabled] => true
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 345678
    [response_code] => 00
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [sent_to_acquirer] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[account_verification]>
    <status content=[approved]>
    <issuer_oct_enabled content=[true]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:00Z]>
    <descriptor content=[Descriptor one]>
    <sent_to_acquirer content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "account_verification",
    status: "approved",
    issuer_oct_enabled: "true",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "345678",
    response_code: "00",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:00Z",
    descriptor: "Descriptor one",
    sent_to_acquirer: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>account_verification</transaction_type>
    <status>approved</status>
    <issuer_oct_enabled>true</issuer_oct_enabled>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <sent_to_acquirer>true</sent_to_acquirer>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Example When Issuer Does Not Support Oct For This Pan:

    Successful Response

    stdClass Object
(
    [transaction_type] => account_verification
    [status] => declined
    [issuer_oct_enabled] => false
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 345678
    [response_code] => 00
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [sent_to_acquirer] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[account_verification]>
    <status content=[declined]>
    <issuer_oct_enabled content=[false]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:00Z]>
    <descriptor content=[Descriptor one]>
    <sent_to_acquirer content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "account_verification",
    status: "declined",
    issuer_oct_enabled: "false",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "345678",
    response_code: "00",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:00Z",
    descriptor: "Descriptor one",
    sent_to_acquirer: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>account_verification</transaction_type>
    <status>declined</status>
    <issuer_oct_enabled>false</issuer_oct_enabled>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <sent_to_acquirer>true</sent_to_acquirer>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    consumer_id string(10) Consumer unique reference. See Consumers
    token string(36) Plain-text token value. See Tokenization
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    issuer_oct_enabled string Present only if merchant has submitted issuer oct enabled flag in the request to check if issuer supports OCTs for the given PAN. True if the issuer supports OCTs for this PAN, false otherwise.
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    sent_to_acquirer string "true" or "false"
    scheme_transaction_identifier string(32) Id defined by card schemes

    Error Response

    stdClass Object
(
    [transaction_type] => account_verification
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => expiration_year is invalid
    [message] => expiration_year is invalid
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[account_verification]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[expiration_year is invalid]>
    <message content=[expiration_year is invalid]>
    <timestamp content=[2019-09-17T15:39:00Z]>
    <descriptor content=[Descriptor one]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "account_verification",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "340",
    technical_message: "expiration_year is invalid",
    message: "expiration_year is invalid",
    timestamp: "2019-09-17T15:39:00Z",
    descriptor: "Descriptor one",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>account_verification</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>expiration_year is invalid</technical_message>
    <message>expiration_year is invalid</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    3DS Card

    Some mids may require that transactions are conducted using 3-D secure technology. This means that a payment is processed asynchronously requiring the user to be redirected to a page where he enters personal data during the process. This improves security and reduces fraudulent transactions while shifting liability from merchants to the issuing banks.

    VISA calls this technology Verified by Visa and Mastercard calls it MasterCard SecureCode.

    The asynchronous workflow may take place on the merchants site in case the merchant has a MPI or wants to use another MPI. In this case a 3-D Secure transaction will be handled synchronous but requires a different parameter signature. See Authorize3d or Sale3d transactions for details.

    In case the merchant does not have a MPI the asynchronous workflow is handled by Genesis and looks like shown in the diagram below:

    3d cards workflow diagram

    Transactions can fail prior to invoking the 3-D mechanism (in case of e.g. invalid card number, expiry date or risk checks). In this case, payment stays synchronous.

    If the card is considered valid for 3-D, payment becomes asynchronous as the user gets redirected to a form at the gateway where he enters additional information.

    The merchant will be notified of the outcome via the notification_url.

    He needs to supply both return_success_url and return_failure_url where the user will be redirected to after the payment has taken place.

    Authorize 3D

    Authorize3D transactions basically have the same request as standard authorize transactions.

    Synchronous Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Authorize3D');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // MPI Synchronous
  ->setCavv('AAACA1BHADYJkIASQkcAAAAAAAA=')
  ->setEci('05')
  ->setXid('0pv62FIrT5qQODB7DCewKgEBAQI=');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.Authorize3DRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    Authorize3DRequest request = new Authorize3DRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Mpi Synchronous
    request.setCavv("AAACA1BHADYJkIASQkcAAAAAAAA=");
    request.setEci("05");
    request.setXid("0pv62FIrT5qQODB7DCewKgEBAQI=");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.authorize3d(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "business_attributes": {
      "event_start_date": "18-10-2019",
      "event_end_date": "28-10-2019",
      "event_organizer_id": "20192375",
      "event_id": "1912"
    },
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "mpi_synchronous": {
      "cavv": "AAACA1BHADYJkIASQkcAAAAAAAA=",
      "eci": "05",
      "xid": "0pv62FIrT5qQODB7DCewKgEBAQI="
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize3d</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <business_attributes>
      <event_start_date>18-10-2019</event_start_date>
      <event_end_date>28-10-2019</event_end_date>
      <event_organizer_id>20192375</event_organizer_id>
      <event_id>1912</event_id>
    </business_attributes>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <mpi_synchronous>
      <cavv>AAACA1BHADYJkIASQkcAAAAAAAA=</cavv>
      <eci>05</eci>
      <xid>0pv62FIrT5qQODB7DCewKgEBAQI=</xid>
    </mpi_synchronous>
  </payment_transaction>'

    Asynchronous Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Authorize3D');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // MPI Asynchronous
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success.html')
  ->setReturnFailureUrl('http://www.example.com/failure.html');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.Authorize3DRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    Authorize3DRequest request = new Authorize3DRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Mpi Asynchronous
    request.setNotificationUrl("https://www.example.com/notification");
    request.setReturnSuccessUrl("http://www.example.com/success.html");
    request.setReturnFailureUrl("http://www.example.com/failure.html");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.authorize3d(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success.html",
    "return_failure_url": "http://www.example.com/failure.html"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize3d</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <mpi_asynchronous>
      <notification_url>https://www.example.com/notification</notification_url>
      <return_success_url>http://www.example.com/success.html</return_success_url>
      <return_failure_url>http://www.example.com/failure.html</return_failure_url>
    </mpi_asynchronous>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: authorize3d
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    gaming optional "true" Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    preauthorization optional "true" Signifies whether a preauthorization transaction is performed. Check the Preauthorizations section or contact tech support for more details.
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    crypto optional "true" Signifies whether a purchase of cryptocurrency transaction is performed. Must be populated when purchasing cryptocurrency with a VISA card and MCC 6051. In this case, the gaming flag must be sent too. Contact tech-support@e-comprocessing.com for more details.
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    notification_url required1 url URL at merchant where gateway sends outcome of transaction.
    return_success_url required1 url URL where customer is sent to after successful payment
    return_failure_url required1 url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_holder required string(255) Full name of customer as printed on credit card (first name and last name at least)
    card_number required 13 to 16 digits Complete cc number of customer
    cvv required 3 to 4 digits cvv of cc, requirement is based on terminal configuration
    expiration_month required MM Expiration month as printed on credit card
    expiration_year required YYYY Expiration year as printed on credit card
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted. Cannot be set together with remember_card
    remember_card optional "true" See Tokenize. Tokenizes cardholder parameters. Cannot be set together with token
    consumer_id optional string(10) See Consumers and Tokenization. Combine with remember_card to tokenize or with token to use token
    credential_on_file required* See Credential On File (COF) for more details
       initial_customer_initiated required* string(18) Initial transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       subsequent_customer_initiated required* string(18) Subsequent transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       merchant_unscheduled optional string(20) Transaction is initiated by the merchant
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    birth_date required* dd-mm-yyyy Required when MCC is a Financial Services one (e.g. MCC 6012) and either card brand is Visa or Mastercard/Maestro with UK-based merchant, UK-based bin (domestic), and DEBIT card type
    document_id required* sring(20) Document ID of the consumer. See Document ID Parameter for more details.
    fx_rate_id optional integer See Get rates for FX Service. Offers the option to use a specific FX rate to convert the transaction processing amount. Used FX rate should have the same source currency as the processing currency. Contact tech-support@e-comprocessing.com for more details.
    business_attributes required* Check business attributes section.
       event_start_date required* dd-mm-yyyy The date when event starts in format dd-mm-yyyy
       event_end_date required* dd-mm-yyyy The date when event ends in format dd-mm-yyyy
       event_organizer_id required* string
       event_id required* string
       date_of_order required* dd-mm-yyyy The date when order was placed in format dd-mm-yyyy
       delivery_date required* dd-mm-yyyy Date of the expected delivery in format dd-mm-yyyy
       name_of_the_supplier required* string
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    mpi_params required2
       cavv required3 string(255) Verification Id of the authentication. Please note this can be the CAVV for Visa Card or UCAF to identify MasterCard.
       eci required3 string(255) See Electronic Commerce Indicator as returned from the MPI for details
       xid required3 string(255) Transaction ID generated by the 3D Secure service that uniquely identifies a 3D Secure check request
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    1 - required if mpi_params is not present, transaction will be handled asynchronous.

    2 - required if transaction should be handled synchronous.

    3 - eci is always required if mpi_params is present. xid and cavv are not required for the 3D attempted only workflow, where the merchant does not have the xid/cavv, only the eci.

    Successful Synchronous Response

    stdClass Object
(
    [transaction_type] => authorize3d
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 345678
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
    [partial_approval] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[authorize3d]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <timestamp content=[2019-09-17T15:39:00Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
    <partial_approval content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "authorize3d",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "345678",
    response_code: "00",
    timestamp: "2019-09-17T15:39:00Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
    partial_approval: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize3d</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
    <partial_approval>true</partial_approval>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Successful Asynchronous Response

    stdClass Object
(
    [transaction_type] => authorize3d
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[authorize3d]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:00Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "authorize3d",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:00Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize3d</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    consumer_id string(10) Consumer unique reference. See Consumers
    token string(36) Plain-text token value. See Tokenization
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    partial_approval string(4) Optional, set to ’true’ if partial approval happened. Partially approved amount is then in the amount field. Check Partial Approvals for details
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.
    scheme_transaction_identifier string(32) Id defined by card schemes

    Error Response

    stdClass Object
(
    [transaction_type] => authorize3d
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 57
    [code] => 340
    [technical_message] => expiration_year is invalid
    [message] => expiration_year is invalid
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[authorize3d]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <response_code content=[57]>
    <code content=[340]>
    <technical_message content=[expiration_year is invalid]>
    <message content=[expiration_year is invalid]>
    <timestamp content=[2019-09-17T15:39:00Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "authorize3d",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    response_code: "57",
    code: "340",
    technical_message: "expiration_year is invalid",
    message: "expiration_year is invalid",
    timestamp: "2019-09-17T15:39:00Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize3d</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code>57</response_code>
    <code>340</code>
    <technical_message>expiration_year is invalid</technical_message>
    <message>expiration_year is invalid</message>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Sale 3D

    Sale3D transactions basically have the same request as standard sale transactions.

    Synchronous Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale3D');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // MPI Synchronous
  ->setCavv('AAACA1BHADYJkIASQkcAAAAAAAA=')
  ->setEci('05')
  ->setXid('0pv62FIrT5qQODB7DCewKgEBAQI=');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.Sale3DRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    Sale3DRequest request = new Sale3DRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Mpi Synchronous
    request.setCavv("AAACA1BHADYJkIASQkcAAAAAAAA=");
    request.setEci("05");
    request.setXid("0pv62FIrT5qQODB7DCewKgEBAQI=");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale3d(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "business_attributes": {
      "event_start_date": "18-10-2019",
      "event_end_date": "28-10-2019",
      "event_organizer_id": "20192375",
      "event_id": "1912"
    },
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "mpi_synchronous": {
      "cavv": "AAACA1BHADYJkIASQkcAAAAAAAA=",
      "eci": "05",
      "xid": "0pv62FIrT5qQODB7DCewKgEBAQI="
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale3d</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <business_attributes>
      <event_start_date>18-10-2019</event_start_date>
      <event_end_date>28-10-2019</event_end_date>
      <event_organizer_id>20192375</event_organizer_id>
      <event_id>1912</event_id>
    </business_attributes>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <mpi_synchronous>
      <cavv>AAACA1BHADYJkIASQkcAAAAAAAA=</cavv>
      <eci>05</eci>
      <xid>0pv62FIrT5qQODB7DCewKgEBAQI=</xid>
    </mpi_synchronous>
  </payment_transaction>'

    Asynchronous Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale3D');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // MPI Asynchronous
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success.html')
  ->setReturnFailureUrl('http://www.example.com/failure.html');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.Sale3DRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    Sale3DRequest request = new Sale3DRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Mpi Asynchronous
    request.setNotificationUrl("https://www.example.com/notification");
    request.setReturnSuccessUrl("http://www.example.com/success.html");
    request.setReturnFailureUrl("http://www.example.com/failure.html");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale3d(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success.html",
    "return_failure_url": "http://www.example.com/failure.html"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale3d</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <mpi_asynchronous>
      <notification_url>https://www.example.com/notification</notification_url>
      <return_success_url>http://www.example.com/success.html</return_success_url>
      <return_failure_url>http://www.example.com/failure.html</return_failure_url>
    </mpi_asynchronous>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: sale3d
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    gaming optional "true" Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    crypto optional "true" Signifies whether a purchase of cryptocurrency transaction is performed. Must be populated when purchasing cryptocurrency with a VISA card and MCC 6051. In this case, the gaming flag must be sent too. Contact tech-support@e-comprocessing.com for more details.
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    notification_url required1 url URL at merchant where gateway sends outcome of transaction.
    return_success_url required1 url URL where customer is sent to after successful payment
    return_failure_url required1 url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_holder required string(255) Full name of customer as printed on credit card (first name and last name at least)
    card_number required 13 to 16 digits Complete cc number of customer
    cvv required 3 to 4 digits cvv of cc, requirement is based on terminal configuration
    expiration_month required MM Expiration month as printed on credit card
    expiration_year required YYYY Expiration year as printed on credit card
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted. Cannot be set together with remember_card
    remember_card optional "true" See Tokenize. Tokenizes cardholder parameters. Cannot be set together with token
    consumer_id optional string(10) See Consumers and Tokenization. Combine with remember_card to tokenize or with token to use token
    credential_on_file required* See Credential On File (COF) for more details
       initial_customer_initiated required* string(18) Initial transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       subsequent_customer_initiated required* string(18) Subsequent transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       merchant_unscheduled optional string(20) Transaction is initiated by the merchant
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    birth_date required* dd-mm-yyyy Required when MCC is a Financial Services one (e.g. MCC 6012) and either card brand is Visa or Mastercard/Maestro with UK-based merchant, UK-based bin (domestic), and DEBIT card type
    document_id required* sring(20) Document ID of the consumer. See Document ID Parameter for more details.
    fx_rate_id optional integer See Get rates for FX Service. Offers the option to use a specific FX rate to convert the transaction processing amount. Used FX rate should have the same source currency as the processing currency. Contact tech-support@e-comprocessing.com for more details.
    business_attributes required* Check business attributes section.
       event_start_date required* dd-mm-yyyy The date when event starts in format dd-mm-yyyy
       event_end_date required* dd-mm-yyyy The date when event ends in format dd-mm-yyyy
       event_organizer_id required* string
       event_id required* string
       date_of_order required* dd-mm-yyyy The date when order was placed in format dd-mm-yyyy
       delivery_date required* dd-mm-yyyy Date of the expected delivery in format dd-mm-yyyy
       name_of_the_supplier required* string
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    mpi_params required2
       cavv required3 string(255) Verification Id of the authentication. Please note this can be the CAVV for Visa Card or UCAF to identify MasterCard.
       eci required3 string(255) See Electronic Commerce Indicator as returned from the MPI for details
       xid required3 string(255) Transaction ID generated by the 3D Secure service that uniquely identifies a 3D Secure check request
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    1 - required if mpi_params is not present, transaction will be handled asynchronous.

    2 - required if transaction should be handled synchronous.

    3 - eci is always required if mpi_params is present. xid and cavv are not required for the 3D attempted only workflow, where the merchant does not have the xid/cavv, only the eci.

    Successful Synchronous Response

    stdClass Object
(
    [transaction_type] => sale3d
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 345678
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:00.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
    [partial_approval] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[sale3d]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <timestamp content=[2019-09-17T15:39:00Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
    <partial_approval content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "sale3d",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "345678",
    response_code: "00",
    timestamp: "2019-09-17T15:39:00Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
    partial_approval: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale3d</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-17T15:39:00Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
    <partial_approval>true</partial_approval>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Successful Asynchronous Response

    stdClass Object
(
    [transaction_type] => sale3d
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[sale3d]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "sale3d",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale3d</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    consumer_id string(10) Consumer unique reference. See Consumers
    token string(36) Plain-text token value. See Tokenization
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    partial_approval string(4) Optional, set to ’true’ if partial approval happened. Partially approved amount is then in the amount field. Check Partial Approvals for details
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.
    scheme_transaction_identifier string(32) Id defined by card schemes

    Error Response

    stdClass Object
(
    [transaction_type] => sale3d
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 57
    [code] => 340
    [technical_message] => expiration_year is invalid
    [message] => expiration_year is invalid
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[sale3d]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <response_code content=[57]>
    <code content=[340]>
    <technical_message content=[expiration_year is invalid]>
    <message content=[expiration_year is invalid]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "sale3d",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    response_code: "57",
    code: "340",
    technical_message: "expiration_year is invalid",
    message: "expiration_year is invalid",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale3d</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code>57</response_code>
    <code>340</code>
    <technical_message>expiration_year is invalid</technical_message>
    <message>expiration_year is invalid</message>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Init Recurring Sale 3D

    InitRecurringSale3D transactions basically have the same request as standard InitRecurringSale transactions.

    Synchronous Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Recurring\InitRecurringSale3D');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // MPI Synchronous
  ->setCavv('AAACA1BHADYJkIASQkcAAAAAAAA=')
  ->setEci('05')
  ->setXid('0pv62FIrT5qQODB7DCewKgEBAQI=');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.recurring.InitRecurringSale3D;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    InitRecurringSale3D request = new InitRecurringSale3D();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Mpi Synchronous
    request.setCavv("AAACA1BHADYJkIASQkcAAAAAAAA=");
    request.setEci("05");
    request.setXid("0pv62FIrT5qQODB7DCewKgEBAQI=");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.init_recurring_sale3d(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "business_attributes": {
      "event_start_date": "18-10-2019",
      "event_end_date": "28-10-2019",
      "event_organizer_id": "20192375",
      "event_id": "1912"
    },
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "mpi_synchronous": {
      "cavv": "AAACA1BHADYJkIASQkcAAAAAAAA=",
      "eci": "05",
      "xid": "0pv62FIrT5qQODB7DCewKgEBAQI="
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>init_recurring_sale3d</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <business_attributes>
      <event_start_date>18-10-2019</event_start_date>
      <event_end_date>28-10-2019</event_end_date>
      <event_organizer_id>20192375</event_organizer_id>
      <event_id>1912</event_id>
    </business_attributes>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <mpi_synchronous>
      <cavv>AAACA1BHADYJkIASQkcAAAAAAAA=</cavv>
      <eci>05</eci>
      <xid>0pv62FIrT5qQODB7DCewKgEBAQI=</xid>
    </mpi_synchronous>
  </payment_transaction>'

    Asynchronous Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Recurring\InitRecurringSale3D');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // MPI Asynchronous
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success.html')
  ->setReturnFailureUrl('http://www.example.com/failure.html');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.recurring.InitRecurringSale3D;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    InitRecurringSale3D request = new InitRecurringSale3D();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Mpi Asynchronous
    request.setNotificationUrl("https://www.example.com/notification");
    request.setReturnSuccessUrl("http://www.example.com/success.html");
    request.setReturnFailureUrl("http://www.example.com/failure.html");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.init_recurring_sale3d(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success.html",
    "return_failure_url": "http://www.example.com/failure.html"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>init_recurring_sale3d</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <mpi_asynchronous>
      <notification_url>https://www.example.com/notification</notification_url>
      <return_success_url>http://www.example.com/success.html</return_success_url>
      <return_failure_url>http://www.example.com/failure.html</return_failure_url>
    </mpi_asynchronous>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: init_recurring_sale3d
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    notification_url required1 url URL at merchant where gateway sends outcome of transaction.
    return_success_url required1 url URL where customer is sent to after successful payment
    return_failure_url required1 url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_holder required string(255) Full name of customer as printed on credit card (first name and last name at least)
    card_number required 13 to 16 digits Complete cc number of customer
    cvv required* 3 to 4 digits cvv of cc, requirement is based on terminal configuration
    expiration_month required MM Expiration month as printed on credit card
    expiration_year required YYYY Expiration year as printed on credit card
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted. Cannot be set together with remember_card
    remember_card optional "true" See Tokenize. Tokenizes cardholder parameters. Cannot be set together with token
    consumer_id optional string(10) See Consumers and Tokenization. Combine with remember_card to tokenize or with token to use token
    credential_on_file required* See Credential On File (COF) for more details
       initial_customer_initiated required* string(18) Initial transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       subsequent_customer_initiated required* string(18) Subsequent transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       merchant_unscheduled optional string(20) Transaction is initiated by the merchant
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    birth_date required* dd-mm-yyyy Required when MCC is a Financial Services one (e.g. MCC 6012) and either card brand is Visa or Mastercard/Maestro with UK-based merchant, UK-based bin (domestic), and DEBIT card type
    document_id required* sring(20) Document ID of the consumer. See Document ID Parameter for more details.
    fx_rate_id optional integer See Get rates for FX Service. Offers the option to use a specific FX rate to convert the transaction processing amount. Used FX rate should have the same source currency as the processing currency. Contact tech-support@e-comprocessing.com for more details.
    business_attributes required* Check business attributes section.
       event_start_date required* dd-mm-yyyy The date when event starts in format dd-mm-yyyy
       event_end_date required* dd-mm-yyyy The date when event ends in format dd-mm-yyyy
       event_organizer_id required* string
       event_id required* string
       date_of_order required* dd-mm-yyyy The date when order was placed in format dd-mm-yyyy
       delivery_date required* dd-mm-yyyy Date of the expected delivery in format dd-mm-yyyy
       name_of_the_supplier required* string
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    mpi_params required2
       cavv required3 string(255) Verification Id of the authentication. Please note this can be the CAVV for Visa Card or UCAF to identify MasterCard.
       eci required3 string(255) See Electronic Commerce Indicator as returned from the MPI for details
       xid required3 string(255) Transaction ID generated by the 3D Secure service that uniquely identifies a 3D Secure check request
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    1 - required if mpi_params is not present, transaction will be handled asynchronous.

    2 - required if transaction should be handled synchronous.

    3 - eci is always required if mpi_params is present. xid and cavv are not required for the 3D attempted only workflow, where the merchant does not have the xid/cavv, only the eci.

    Successful Synchronous Response

    stdClass Object
(
    [transaction_type] => init_recurring_sale3d
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 345678
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
    [partial_approval] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[init_recurring_sale3d]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
    <partial_approval content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "init_recurring_sale3d",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "345678",
    response_code: "00",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
    partial_approval: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>init_recurring_sale3d</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
    <partial_approval>true</partial_approval>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Successful Asynchronous Response

    stdClass Object
(
    [transaction_type] => init_recurring_sale3d
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
    [scheme_transaction_identifier] => 019091214161031
)

    <payment_response content=[
    <transaction_type content=[init_recurring_sale3d]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
    <scheme_transaction_identifier content=[019091214161031]>
]>

    {
    transaction_type: "init_recurring_sale3d",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
    scheme_transaction_identifier: "019091214161031",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>init_recurring_sale3d</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
    <scheme_transaction_identifier>019091214161031</scheme_transaction_identifier>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    consumer_id string(10) Consumer unique reference. See Consumers
    token string(36) Plain-text token value. See Tokenization
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    recurring_advice_code string(2) if received in the response from the issuer
    recurring_advice_text string Optional, describes the specific recurring advice code
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    partial_approval string(4) Optional, set to ’true’ if partial approval happened. Partially approved amount is then in the amount field. Check Partial Approvals for details
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.
    scheme_transaction_identifier string(32) Id defined by card schemes

    Error Response

    stdClass Object
(
    [transaction_type] => init_recurring_sale3d
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 57
    [code] => 340
    [technical_message] => expiration_year is invalid
    [message] => expiration_year is invalid
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[init_recurring_sale3d]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <response_code content=[57]>
    <code content=[340]>
    <technical_message content=[expiration_year is invalid]>
    <message content=[expiration_year is invalid]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "init_recurring_sale3d",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    response_code: "57",
    code: "340",
    technical_message: "expiration_year is invalid",
    message: "expiration_year is invalid",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>init_recurring_sale3d</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code>57</response_code>
    <code>340</code>
    <technical_message>expiration_year is invalid</technical_message>
    <message>expiration_year is invalid</message>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Notification for Asynchronous Payments

    When using asynchronous payments like 3-D secured transactions, the transaction depends on user input. Therefore, the outcome of the transaction is not available immediately after sending the request.

    The gateway will send a notification to the merchant’s server as soon as the payment has been completed (either approved or declined).

    If the user cancels the payment (or the user doesn't complete the payment within the given time frame, e.g. 2 hours), the transaction will time out and a notification will be sent.

    The notification will be sent as an HTTP POST to the notification_url specified in the transaction request XML. See Notifications for the HTTP POST-Data and format. Notification will be pure HTTP or HTTPS-based, depending on the URL given by the merchant in the notification_url. In case it is a HTTPS-based notification, no SSL verification of the merchant SSL certificate will be performed. Until a notification echo is rendered by the merchant, there will be up to 10 notifications sent, each with a timeout of 15 minutes. Note that notifications in the PROD env will be sent from 80.82.206.228 and 5.179.225.28 for the PROD env, and only 80.82.206.228 for the STG env, so make sure these IP addresses are whitelisted respectively. Note also that notifications are delivered to either port 80 (HTTP notification) or port 443 (HTTPS notification), so make sure the correct notification_url is passed in the transaction request in the first place.

    Also see 3-D secure workflow.

    Wallets

    Neteller

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Wallets\Neteller');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCustomerAccount('453501020503')
  ->setAccountPassword('908379')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.wallets.NetellerRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    NetellerRequest request = new NetellerRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setNotificationUrl(new URL("https://www.example.com/notification"));
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCustomerAccount("453501020503");
    request.setAccountPassword("908379");
    request.setCustomerEmail("travis@example.com");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.neteller(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "USD",
    "customer_account": "453501020503",
    "account_password": "908379",
    "customer_email": "travis@example.com",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>neteller</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <customer_account>453501020503</customer_account>
    <account_password>908379</account_password>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: neteller
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    customer_account required string(100) Customer email/id of neteller account
    account_password required string(6) Account secret password
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => neteller
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[neteller]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "neteller",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>neteller</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => neteller
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[neteller]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "neteller",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>neteller</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    PayPal Express Checkout

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\PaypalExpress');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.PayPalExpressRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PayPalExpressRequest request = new PayPalExpressRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setNotificationUrl(new URL("https://www.example.com/notification"));
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCustomerEmail("travis@example.com");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.paypal_express(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "USD",
    "customer_email": "travis@example.com",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>paypal_express</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: paypal_express
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => paypal_express
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[paypal_express]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "paypal_express",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>paypal_express</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => paypal_express
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[paypal_express]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "paypal_express",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>paypal_express</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    QIWI

    QIWI Wallet is a very popular Eastern European e-wallet.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>qiwi</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>5000</amount>
    <currency>RUB</currency>
    <customer_phone>71234567891</customer_phone>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Moscow</city>
      <country>RU</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\PPRO');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setPaymentType('qiwi')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('5000')
  ->setCurrency('RUB')
  ->setCustomerPhone('71234567891')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Moscow')
  ->setBillingCountry('RU')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.PProRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PProRequest request = new PProRequest();

    request.setTransactionId("43671");
    request.setPaymentType("qiwi");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(5000));
    request.setCurrency("RUB");
    request.setCustomerPhone("71234567891");


    // Billing Address
    request.setBillingFirstname("Barney");
    request.setBillingLastname("Rubble");
    request.setBillingPrimaryAddress("14, Nerazdelni str");
    request.setBillingZipCode("1407");
    request.setBillingCity("Moscow");
    request.setBillingCountry("RU");


    // Risk Params
    request.setRiskUserId("123456");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.ppro(
  {
    "transaction_id": "43671",
    "payment_type": "qiwi",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "5000",
    "currency": "RUB",
    "customer_phone": "71234567891",
    "billing_address": {
      "first_name": "Barney",
      "last_name": "Rubble",
      "address1": "14, Nerazdelni str",
      "zip_code": "1407",
      "city": "Moscow",
      "country": "RU"
    },
    "risk_params": {
      "user_id": "123456"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <transaction_id>43671</transaction_id>
    <payment_type>qiwi</payment_type>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>5000</amount>
    <currency>RUB</currency>
    <customer_phone>71234567891</customer_phone>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Moscow</city>
      <country>RU</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) ppro or qiwi. Contact tech support at tech-support@e-comprocessing.com for more details.
    transaction_id required string(255) Unique transaction id defined by merchant
    payment_type required1 qiwi QIWI. Contact tech support at tech-support@e-comprocessing.com for more details.
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_phone required string(11) Must be a 10 digits Russian valid mobile number(either with or without international prefix +7), or International mobile phone number, starting with + followed by at least 9 digits.
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    1 - payment_type must be submitted only when the transaction type is set to ppro

    Supported countries and countries

    Country code Currency code
    RU EUR, RUB
    KZ EUR, KZT
    UA USD

    Successful Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 5000
    [currency] => RUB
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5000]>
    <currency content=[RUB]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "5000",
    currency: "RUB",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5000</amount>
    <currency>RUB</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 5000
    [currency] => RUB
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5000]>
    <currency content=[RUB]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "5000",
    currency: "RUB",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5000</amount>
    <currency>RUB</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    WebMoney

    Auth Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Wallets\WebMoney');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setCustomerPhone('+1987987987987')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.wallets.WebMoneyRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    WebMoneyRequest request = new WebMoneyRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setCustomerPhone("+1987987987987");
    request.setCustomerEmail("travis@example.com");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.webmoney(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "customer_phone": "+1987987987987",
    "customer_email": "travis@example.com",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>webmoney</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <customer_phone>+1987987987987</customer_phone>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Payout Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Wallets\WebMoney');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setIsPayout('true')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setCustomerPhone('+1987987987987')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.wallets.WebMoneyRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    WebMoneyRequest request = new WebMoneyRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setIsPayout("true");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setCustomerPhone("+1987987987987");
    request.setCustomerEmail("travis@example.com");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.webmoney(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "is_payout": "true",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "customer_phone": "+1987987987987",
    "customer_email": "travis@example.com",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>webmoney</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <is_payout>true</is_payout>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <customer_phone>+1987987987987</customer_phone>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: webmoney
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    is_payout required* string Value:true/false Flag for payout transaction
    customer_account_id required* string(12) Webmoney account ID (WMID). This field is required if is payout is set to "true"
    customer_email required e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Auth Response

    stdClass Object
(
    [transaction_type] => webmoney
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[webmoney]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "webmoney",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>webmoney</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Payout Response

    stdClass Object
(
    [transaction_type] => webmoney
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[webmoney]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "webmoney",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>webmoney</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => webmoney
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[webmoney]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "webmoney",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>webmoney</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Wechat

    Supported countries: All countries are supported

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\WeChat');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnUrl('https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setProductCode('product-code')
  ->setProductNum('1234')
  ->setProductDesc('Product description')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.oBeP.WechatRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    WechatRequest request = new WechatRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setNotificationUrl(new URL("https://www.example.com/notification"));
    request.setReturnUrl(new URL("https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setProductCode("product-code");
    request.setProductNum("1234");
    request.setProductDesc("Product description");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.wechat(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "notification_url": "https://www.example.com/notification",
    "return_url": "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f",
    "amount": "100",
    "currency": "USD",
    "product_code": "product-code",
    "product_num": "1234",
    "product_desc": "Product description",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>wechat</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f</return_url>
    <amount>100</amount>
    <currency>USD</currency>
    <product_code>product-code</product_code>
    <product_num>1234</product_num>
    <product_desc>Product description</product_desc>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: wechat
    transaction_id required string(30) Unique transaction id defined by merchant
    usage required string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    notification_url required url URL at merchant where gateway sends outcome of transaction.
    return_url required url URL where consumer is sent to after payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    Max amount in minor currency unit: 999999
    currency required string(3) Currency code in ISO 4217
    product_code optional string(60) Product code
    product_num optional integer(10) Product number
    product_desc optional string(255) Product description
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => wechat
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[wechat]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "wechat",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>wechat</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(30) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => wechat
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Please check input data for errors!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[wechat]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Please check input data for errors!]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "wechat",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Please check input data for errors!",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>wechat</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Please check input data for errors!</message>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(30) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Zimpler

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Wallets\Zimpler');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('SEK')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Stockholm')
  ->setBillingCountry('SE')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>zimpler</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>SEK</currency>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Stockholm</city>
      <country>SE</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: zimpler
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    customer_phone optional string(32) Must be 6, 7 or 8 digits Swedish or Finnish valid mobile number(either with or without international prefix +46, +358 or 0).
    billing_address required See Required vs Optional API params for details
       first_name required string(255) Customer first name
       last_name required string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported currencies and countries:

    Currency code Country code
    EUR FI
    SEK SE

    Successful Response

    stdClass Object
(
    [transaction_type] => zimpler
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => SEK
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>zimpler</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>SEK</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => zimpler
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => SEK
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>zimpler</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>SEK</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Vouchers

    CashU

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Vouchers\CashU');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.CashURequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    CashURequest request = new CashURequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.cashu(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "EUR",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>cashu</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: cashu
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries

    Country name Country code
    Algeria DZ
    Bahrain BH
    Egypt EG
    Gambia GM
    Ghana GH
    India IN
    Iran IR
    Iraq IQ
    Israel IL
    Jordan JO
    Kenya KE
    Korea KP
    Kuwait KW
    Lebanon LB
    Libya LY
    Malaysia MY
    Mauritania MR
    Morocco MA
    Nigeria NG
    Oman OM
    Pakistan PK
    Palestine PS
    Qatar QA
    Saudi Arabia SA
    Sierra Leone SL
    Sudan SD
    Syria SY
    Tanzania TZ
    Tunisia TN
    Turkey TR
    United Arab Emirates AE
    United States US
    Yemen YE

    Supported currencies

    Currency name Currency code
    Algerian Dinar DZD
    AmericanDollar USD
    EgyptianPound EGP
    Euro EUR
    JordanianDinar JOD
    LebanesePound LBP
    MoroccanDirham MAD
    Qatar Riyal QAR
    Saudi Riyal SAR
    Turkish Lira TRY
    UAE Dirham AED

    Successful Response

    stdClass Object
(
    [transaction_type] => cashu
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:01.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[cashu]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:01Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "cashu",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:01Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>cashu</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:01Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => cashu
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[cashu]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:02Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "cashu",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:02Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>cashu</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Neosurf

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Vouchers\Neosurf');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setVoucherNumber('')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('23, Doestreet')
  ->setBillingZipCode('11923')
  ->setBillingCity('New York City')
  ->setBillingCountry('DE');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>neosurf</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>EUR</currency>
    <voucher_number nil="true"/>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>23, Doestreet</address1>
      <zip_code>11923</zip_code>
      <city>New York City</city>
      <country>DE</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: neosurf
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    voucher_number required string(10) Voucher number. Alphanumeric maximum 10 characters
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries

    Country Name Country code
    Austria AT
    Algeria DZ
    Australia AU
    Burundi BI
    Burkina Faso BF
    Benin BJ
    Belgium BE
    Cape Verde CV
    Cyprus CY
    Canada CA
    Central African Republic CF
    Chad TD
    Colombia CO
    Congo CG
    Cameroon CM
    Democratic Republic of Congo CD
    Denmark DK
    Equatorial Guinea GQ
    France FR
    Gambia GM
    Germany DE
    Gabon GA
    Guinea GN
    Ghana GH
    Guinea-Bissau GW
    Hong Kong HK
    Ireland IE
    Italy IT
    Ivory Coast CI
    Kenya KE
    Luxembourg LU
    Malawi MW
    Mozambique MZ
    Morocco MA
    Mauritania MR
    Mali ML
    Niger NE
    Nigeria NG
    Netherlands NL
    New Zealand NZ
    Norway NO
    Poland PL
    Portugal PT
    Rwanda RW
    Russia RU
    Romania RO
    Sweden SE
    Spain ES
    Sierra Leone SL
    Senegal SN
    Sao Tome and Principe ST
    Switzerland CH
    Serbia RS
    Turkey TR
    Togo TG
    Tunisia TN
    United Kingdom GB
    United Republic of Tanzania TZ
    Uganda UG
    Zimbabwe ZW
    Zambia ZM

    Successful Response

    stdClass Object
(
    [transaction_type] => neosurf
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>neosurf</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => neosurf
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => false
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>neosurf</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Paysafecard

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Vouchers\Paysafecard');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.PaySafeCardRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PaySafeCardRequest request = new PaySafeCardRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.paysafecard(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "USD",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>paysafecard</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: paysafecard
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country name Country code
    Austria AT
    Belgium BE
    Canada CA
    Czech Republic CZ
    Cyprus CY
    Croatia HR
    Denmark DK
    Finland FI
    France FR
    Germany DE
    Greece GR
    Hungary HU
    Ireland IE
    Italy IT
    Luxembourg LU
    Mexico MX
    Malta MT
    Netherlands NL
    Norway NO
    Portugal PT
    Poland PL
    Romania RO
    Sweden SE
    Slovenia SI
    Slovakia SK
    Switzerland CH
    Spain ES
    Turkey TR
    United Arab Emirates AE
    United Kingdom GB
    United States US

    Successful Response

    stdClass Object
(
    [transaction_type] => paysafecard
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[paysafecard]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:02Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "paysafecard",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:02Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>paysafecard</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => paysafecard
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[paysafecard]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:02Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "paysafecard",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:02Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>paysafecard</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Online Banking ePayments (oBeP)

    Online Banking ePayments refer to payment methods that are used as an alternative to credit card payments allowing consumers to pay online with their bank account.

    Banco do Brasil

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\BancoDoBrasil');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rubble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Natal')
  ->setBillingCountry('BR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>banco_do_brasil</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Natal</city>
      <country>BR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: banco_do_brasil
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    BR

    Successful Response

    stdClass Object
(
    [transaction_type] => banco_do_brasil
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>banco_do_brasil</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => banco_do_brasil
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>banco_do_brasil</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Bancomer

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\Bancomer');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rubble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Mexico City')
  ->setBillingCountry('MX')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bancomer</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Mexico City</city>
      <country>MX</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: bancomer
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    MX

    Successful Response

    stdClass Object
(
    [transaction_type] => bancomer
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bancomer</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => bancomer
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bancomer</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Bradesco

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\Bradesco');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rubble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Rio de Janeiro')
  ->setBillingCountry('BR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bradesco</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Rio de Janeiro</city>
      <country>BR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: bradesco
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    BR

    Successful Response

    stdClass Object
(
    [transaction_type] => bradesco
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bradesco</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => bradesco
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bradesco</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Entercash

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\Entercash');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setConsumerReference('123456')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Graz')
  ->setBillingCountry('AT')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>entercash</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <consumer_reference>123456</consumer_reference>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Graz</city>
      <country>AT</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: entercash
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    iban optional string Valid German (when selected Germany as country) or Austrian (when selected Austria as country) IBAN
    bic optional string Valid BIC when Germany or Austria selected as country
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported currencies and countries:

    Currency code Country code
    EUR AT
    EUR DE
    EUR FI
    SEK SE

    Successful Response

    stdClass Object
(
    [transaction_type] => entercash
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>entercash</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => entercash
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>entercash</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    EPS

    EPS is the main bank transfer payment method in Austria. Every transaction is guaranteed via the scheme.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>eps</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Vienna</city>
      <country>AT</country>
    </billing_address>
  </payment_transaction>'

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\PPRO');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setPaymentType('eps')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Vienna')
  ->setBillingCountry('AT');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.PProRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PProRequest request = new PProRequest();

    request.setTransactionId("43671");
    request.setPaymentType("eps");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");


    // Billing Address
    request.setBillingFirstname("Barney");
    request.setBillingLastname("Rubble");
    request.setBillingPrimaryAddress("14, Nerazdelni str");
    request.setBillingZipCode("1407");
    request.setBillingCity("Vienna");
    request.setBillingCountry("AT");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.ppro(
  {
    "transaction_id": "43671",
    "payment_type": "eps",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "EUR",
    "billing_address": {
      "first_name": "Barney",
      "last_name": "Rubble",
      "address1": "14, Nerazdelni str",
      "zip_code": "1407",
      "city": "Vienna",
      "country": "AT"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <transaction_id>43671</transaction_id>
    <payment_type>eps</payment_type>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Vienna</city>
      <country>AT</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) ppro or eps. Contact tech support at tech-support@e-comprocessing.com for more details.
    transaction_id required string(255) Unique transaction id defined by merchant
    payment_type required1 eps EPS. Contact tech support for more details.
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    1 - payment_type must be submitted only when the transaction type is set to ppro

    Supported countries and countries

    Currency code Country code
    EUR AT

    Successful Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:02Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:02Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:02Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:02Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    GiroPay

    GiroPay is a popular real-time bank transfer payment method in Germany that integrates more than 1,500 German banks.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>giropay</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Berlin</city>
      <country>DE</country>
    </billing_address>
  </payment_transaction>'

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\PPRO');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setPaymentType('giropay')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setBic('GENODETT488')
  ->setIban('DE07444488880123456789')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Berlin')
  ->setBillingCountry('DE');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.PProRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PProRequest request = new PProRequest();

    request.setTransactionId("43671");
    request.setPaymentType("giropay");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");
    request.setBic("GENODETT488");
    request.setIban("DE07444488880123456789");


    // Billing Address
    request.setBillingFirstname("Barney");
    request.setBillingLastname("Rubble");
    request.setBillingPrimaryAddress("14, Nerazdelni str");
    request.setBillingZipCode("1407");
    request.setBillingCity("Berlin");
    request.setBillingCountry("DE");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.ppro(
  {
    "transaction_id": "43671",
    "payment_type": "giropay",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "EUR",
    "bic": "GENODETT488",
    "iban": "DE07444488880123456789",
    "billing_address": {
      "first_name": "Barney",
      "last_name": "Rubble",
      "address1": "14, Nerazdelni str",
      "zip_code": "1407",
      "city": "Berlin",
      "country": "DE"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <transaction_id>43671</transaction_id>
    <payment_type>giropay</payment_type>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <bic>GENODETT488</bic>
    <iban>DE07444488880123456789</iban>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Berlin</city>
      <country>DE</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) ppro or giropay. Contact tech support at tech-support@e-comprocessing.com for more details.
    transaction_id required string(255) Unique transaction id defined by merchant
    payment_type required1 giropay GiroPay. Contact tech support for more details.
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    bic required string(11) Valid BIC string. Must be 8 or 11 characters long
    iban required* string(22) String must start with ”DE” followed by 20 digits
    billing_address required See Required vs Optional API params for details
       first_name required string(255) Customer first name
       last_name required string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    1 - payment_type must be submitted only when the transaction type is set to ppro

    Supported currencies and countries

    Currency code Country code
    EUR DE

    Successful Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:02Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:02Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:02Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:02Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    iDebit

    Supported countries

    Country name Country code
    Canada CA

    iDebit is available only for Canadian merchants and consumers.

    Payin

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\iDebit\Payin');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setCustomerAccountId('1534537')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnUrl('https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f')
  ->setAmount('100')
  ->setCurrency('CAD')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('46 Donora Dr')
  ->setBillingZipCode('M4B1B3')
  ->setBillingCity('Toronto')
  ->setBillingState('ON')
  ->setBillingCountry('CA');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.oBeP.IDebitPayInRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    IDebitPayInRequest request = new IDebitPayInRequest();

    request.setTransactionId("43671");
    request.setCustomerAccountId("1534537");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setNotificationUrl(new URL("https://www.example.com/notification"));
    request.setReturnUrl(new URL("https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("CAD");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("46 Donora Dr");
    request.setBillingZipCode("M4B1B3");
    request.setBillingCity("Toronto");
    request.setBillingState("ON");
    request.setBillingCountry("CA");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.idebit_payin(
  {
    "transaction_id": "43671",
    "customer_account_id": "1534537",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "notification_url": "https://www.example.com/notification",
    "return_url": "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f",
    "amount": "100",
    "currency": "CAD",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "46 Donora Dr",
      "zip_code": "M4B1B3",
      "city": "Toronto",
      "state": "ON",
      "country": "CA"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>idebit_payin</transaction_type>
    <transaction_id>43671</transaction_id>
    <customer_account_id>1534537</customer_account_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f</return_url>
    <amount>100</amount>
    <currency>CAD</currency>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>46 Donora Dr</address1>
      <zip_code>M4B1B3</zip_code>
      <city>Toronto</city>
      <state>ON</state>
      <country>CA</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: idebit_payin
    transaction_id required string(30) Unique transaction id defined by merchant
    usage required* string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    customer_account_id required string(20) Unique consumer account ID
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    birth_date required* dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => idebit_payin
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => CAD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[idebit_payin]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:02Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[CAD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "idebit_payin",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:02Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "CAD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>idebit_payin</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>CAD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(30) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => idebit_payin
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 320
    [message] => amount is missing!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:02.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => CAD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[idebit_payin]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[320]>
    <message content=[amount is missing!]>
    <timestamp content=[2019-09-17T15:39:02Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[CAD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "idebit_payin",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "320",
    message: "amount is missing!",
    timestamp: "2019-09-17T15:39:02Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "CAD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>idebit_payin</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>320</code>
    <message>amount is missing!</message>
    <timestamp>2019-09-17T15:39:02Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>CAD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(30) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Payout

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\iDebit\Payout');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setReferenceId('43672')
  ->setAmount('100')
  ->setCurrency('CAD');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.oBeP.IDebitPayOutRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    IDebitPayOutRequest request = new IDebitPayOutRequest();

    request.setTransactionId("43671");
    request.setReferenceId("43672");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("CAD");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.idebit_payout(
  {
    "transaction_id": "43671",
    "reference_id": "43672",
    "amount": "100",
    "currency": "CAD"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>idebit_payout</transaction_type>
    <transaction_id>43671</transaction_id>
    <reference_id>43672</reference_id>
    <amount>100</amount>
    <currency>CAD</currency>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: idebit_payout
    transaction_id required string(30) Unique transaction id defined by merchant
    reference_id required string(32) Unique id returned by corresponding transaction
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => idebit_payout
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [amount] => 100
    [currency] => CAD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[idebit_payout]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <amount content=[100]>
    <currency content=[CAD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "idebit_payout",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:03Z",
    amount: "100",
    currency: "CAD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>idebit_payout</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <amount>100</amount>
    <currency>CAD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(30) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => idebit_payout
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [technical_message] => amount is missing!
    [message] => Please check input data for errors!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [amount] => 100
    [currency] => CAD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[idebit_payout]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <technical_message content=[amount is missing!]>
    <message content=[Please check input data for errors!]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <amount content=[100]>
    <currency content=[CAD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "idebit_payout",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    technical_message: "amount is missing!",
    message: "Please check input data for errors!",
    timestamp: "2019-09-17T15:39:03Z",
    amount: "100",
    currency: "CAD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>idebit_payout</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <technical_message>amount is missing!</technical_message>
    <message>Please check input data for errors!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <amount>100</amount>
    <currency>CAD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(30) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    iDeal

    iDeal is the most popular payment method in the Netherlands and is a real-time bank transfer system covering all major Dutch consumer banks.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ideal</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Amsterdam</city>
      <country>NL</country>
    </billing_address>
  </payment_transaction>'

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\PPRO');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setPaymentType('ideal')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Amsterdam')
  ->setBillingCountry('NL');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.PProRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PProRequest request = new PProRequest();

    request.setTransactionId("43671");
    request.setPaymentType("ideal");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");


    // Billing Address
    request.setBillingFirstname("Barney");
    request.setBillingLastname("Rubble");
    request.setBillingPrimaryAddress("14, Nerazdelni str");
    request.setBillingZipCode("1407");
    request.setBillingCity("Amsterdam");
    request.setBillingCountry("NL");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.ppro(
  {
    "transaction_id": "43671",
    "payment_type": "ideal",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "EUR",
    "billing_address": {
      "first_name": "Barney",
      "last_name": "Rubble",
      "address1": "14, Nerazdelni str",
      "zip_code": "1407",
      "city": "Amsterdam",
      "country": "NL"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <transaction_id>43671</transaction_id>
    <payment_type>ideal</payment_type>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Amsterdam</city>
      <country>NL</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) ppro or ideal. Contact tech support at tech-support@e-comprocessing.com for more details.
    transaction_id required string(255) Unique transaction id defined by merchant
    payment_type required1 ideal iDeal. Contact tech support at tech-support@e-comprocessing.com for more details.
    usage optional string(255) Description of the transaction for later use
    bic optional string(11) SWIFT/BIC code of the customer’s bank
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    1 - payment_type must be submitted only when the transaction type is set to ppro

    Supported currencies and countries

    Currency code Country code
    EUR NL

    Successful Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:03Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:03Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    InstaDebit

    Supported countries

    Country name Country code
    Canada CA

    InstaDebit is available only for Canadian merchants and consumers.

    Payin

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\InstaDebit\Payin');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setCustomerAccountId('118221674199')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnUrl('https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f')
  ->setAmount('100')
  ->setCurrency('CAD')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('46 Donora Dr')
  ->setBillingZipCode('M4B1B3')
  ->setBillingCity('Toronto')
  ->setBillingState('ON')
  ->setBillingCountry('CA');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.oBeP.InstaDebitPayInRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    InstaDebitPayInRequest request = new InstaDebitPayInRequest();

    request.setTransactionId("43671");
    request.setCustomerAccountId("118221674199");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setNotificationUrl(new URL("https://www.example.com/notification"));
    request.setReturnUrl(new URL("https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("CAD");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("46 Donora Dr");
    request.setBillingZipCode("M4B1B3");
    request.setBillingCity("Toronto");
    request.setBillingState("ON");
    request.setBillingCountry("CA");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.insta_debit_payin(
  {
    "transaction_id": "43671",
    "customer_account_id": "118221674199",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "notification_url": "https://www.example.com/notification",
    "return_url": "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f",
    "amount": "100",
    "currency": "CAD",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "46 Donora Dr",
      "zip_code": "M4B1B3",
      "city": "Toronto",
      "state": "ON",
      "country": "CA"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>insta_debit_payin</transaction_type>
    <transaction_id>43671</transaction_id>
    <customer_account_id>118221674199</customer_account_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f</return_url>
    <amount>100</amount>
    <currency>CAD</currency>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>46 Donora Dr</address1>
      <zip_code>M4B1B3</zip_code>
      <city>Toronto</city>
      <state>ON</state>
      <country>CA</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: insta_debit_payin
    transaction_id required string(30) Unique transaction id defined by merchant
    customer_account_id required string(20) Unique consumer account ID
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_url required url URL where consumer is sent to after payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => insta_debit_payin
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => CAD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[insta_debit_payin]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[CAD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "insta_debit_payin",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:03Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "CAD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>insta_debit_payin</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>CAD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(30) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => insta_debit_payin
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [message] => Please check input data for errors!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => CAD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[insta_debit_payin]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <message content=[Please check input data for errors!]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[CAD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "insta_debit_payin",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    message: "Please check input data for errors!",
    timestamp: "2019-09-17T15:39:03Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "CAD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>insta_debit_payin</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <message>Please check input data for errors!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>CAD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(30) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Payout

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\InstaDebit\Payout');
$request = $genesis->request();

$request
  ->setReferenceId('43672')
  ->setAmount('100')
  ->setCurrency('CAD');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.oBeP.InstaDebitPayOutRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    InstaDebitPayOutRequest request = new InstaDebitPayOutRequest();

    request.setReferenceId("43672");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("CAD");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.insta_debit_payout(
  {
    "reference_id": "43672",
    "amount": "100",
    "currency": "CAD"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <reference_id>43672</reference_id>
    <amount>100</amount>
    <currency>CAD</currency>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: insta_debit_payout
    transaction_id required string(30) Unique transaction id defined by merchant
    reference_id required string(32) unique id of approved InstaDebit Payin transaction. See InstaDebit Payin Response, unique id
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    Max amount in minor currency unit: 999999
    currency required string(3) Currency code in ISO 4217

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => insta_debit_payout
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [amount] => 100
    [currency] => CAD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[insta_debit_payout]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <amount content=[100]>
    <currency content=[CAD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "insta_debit_payout",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:03Z",
    amount: "100",
    currency: "CAD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>insta_debit_payout</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <amount>100</amount>
    <currency>CAD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(30) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => insta_debit_payout
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 320
    [technical_message] => amount is missing!
    [message] => Please check input data for errors!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [amount] => 100
    [currency] => CAD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[insta_debit_payout]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[320]>
    <technical_message content=[amount is missing!]>
    <message content=[Please check input data for errors!]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <amount content=[100]>
    <currency content=[CAD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "insta_debit_payout",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "320",
    technical_message: "amount is missing!",
    message: "Please check input data for errors!",
    timestamp: "2019-09-17T15:39:03Z",
    amount: "100",
    currency: "CAD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>insta_debit_payout</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>320</code>
    <technical_message>amount is missing!</technical_message>
    <message>Please check input data for errors!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <amount>100</amount>
    <currency>CAD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(30) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    InstantTransfer

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\InstantTransfer');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setIban('DE07444488880123456789')
  ->setBic('GENODETT488')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Berlin')
  ->setBillingCountry('DE')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>instant_transfer</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <iban>DE07444488880123456789</iban>
    <bic>GENODETT488</bic>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Berlin</city>
      <country>DE</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: instant_transfer
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    iban optional string(34) Customer’s IBAN number
    bic optional string(11) SWIFT/BIC code of the customer’s bank
    customer_email optional e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country code
    DE

    Successful Response

    stdClass Object
(
    [transaction_type] => instant_transfer
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>instant_transfer</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => instant_transfer
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>instant_transfer</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Itau

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\Itau');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rubble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Rio de Janeiro')
  ->setBillingCountry('BR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>itau</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Rio de Janeiro</city>
      <country>BR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: itau
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    BR

    Successful Response

    stdClass Object
(
    [transaction_type] => itau
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>itau</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => itau
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>itau</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Multibanco

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\Multibanco');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Porto')
  ->setBillingCountry('PT')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>multibanco</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Porto</city>
      <country>PT</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: multibanco
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email optional e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country code
    PT

    Successful Response

    stdClass Object
(
    [transaction_type] => multibanco
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>multibanco</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => multibanco
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>multibanco</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    My Bank

    My Bank is an overlay banking system for Belgium, France, Italy, Spain, Greece and Luxembourg.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>my_bank</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Rome</city>
      <country>IT</country>
    </billing_address>
  </payment_transaction>'

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\PPRO');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setPaymentType('mybank')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Rome')
  ->setBillingCountry('IT');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.PProRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PProRequest request = new PProRequest();

    request.setTransactionId("43671");
    request.setPaymentType("mybank");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");


    // Billing Address
    request.setBillingFirstname("Barney");
    request.setBillingLastname("Rubble");
    request.setBillingPrimaryAddress("14, Nerazdelni str");
    request.setBillingZipCode("1407");
    request.setBillingCity("Rome");
    request.setBillingCountry("IT");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.ppro(
  {
    "transaction_id": "43671",
    "payment_type": "mybank",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "EUR",
    "billing_address": {
      "first_name": "Barney",
      "last_name": "Rubble",
      "address1": "14, Nerazdelni str",
      "zip_code": "1407",
      "city": "Rome",
      "country": "IT"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <transaction_id>43671</transaction_id>
    <payment_type>mybank</payment_type>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Rome</city>
      <country>IT</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) ppro or my_bank. Contact tech support at tech-support@e-comprocessing.com for more details.
    transaction_id required string(255) Unique transaction id defined by merchant
    payment_type required1 ppro MyBank. Contact tech support at tech-support@e-comprocessing.com for more details.
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    1 - payment_type must be submitted only when the transaction type is set to ppro

    Supported currencies and countries

    Currency code Country code Description
    EUR BE, FR, IT, LU for PPro transaction type
    EUR IT, ES, GR for MyBank transaction type

    Successful Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:03Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:03Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Online Banking

    Online Banking is an oBeP-style alternative payment method that allows you to pay directly with your ebank account. After initiating a transaction, the online banking will redirect you to their page. There you will find a list with available banks to finish the payment.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\OnlineBanking\Payin');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('50000')
  ->setCurrency('CNY')
  ->setCustomerEmail('travis@example.com')
  ->setBankCode('CITIC')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>online_banking</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>50000</amount>
    <currency>CNY</currency>
    <customer_email>travis@example.com</customer_email>
    <bank_code>CITIC</bank_code>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: online_banking
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    bank_code required bank code Must contain Bank code
    document_id required* sring(20) Document ID of the consumer. See Document ID Parameter for more details.
    payment_type required* string The payment type describes the type of online banking used to process the transaction. Allowed values are quick_payment, qr_payment or online_banking, but they may vary based on the specific setup. If omitted, transaction will be processed with online_banking payment_type.
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166

    required* = conditionally required

    Supported currencies

    Currency name Currency code
    Argentine Peso ARS
    China yen CNY
    Chilean Peso CLP
    Colombian Peso COP
    Indian rupee INR
    Indonesian rupiah IDR
    Malaysian ringgit MYR
    Paraguayan Guarani PYG
    Philippine peso PHP
    Singapore dollar SGD
    Thai baht THB
    Uruguayan Peso UYU
    Vietnamese dong VND

    Bank Codes

    For ARS currency:

    Bank Name Bank Code
    DirectDebit DB

    For BRL currency:

    Bank Name Bank Code
    Caixa DB

    For CLP currency:

    Bank Name Bank Code
    Servipag SP

    For CNY currency

    Bank Name Bank Code
    Agricultural Bank of China ABC
    Bank of Beijing BOB
    Bank of China BOC
    Bank of Communications BOCO
    China Construction Bank CCB
    Bank for economic construction CCD
    China Everbright Bank CEB
    Industrial Bank CIB
    China Merchants Bank CMB
    China Minsheng Bank CMBC
    China Citic Bank CITIC
    Industrial and Commercial Bank of China ICBC
    China Guangfa Bank GDB
    Huaxia Bank HXB
    Pingan Bank PINGANBANK
    China Postal Savings Bank PSBC
    China Union Pay QUICKPAY
    Shanghai Bank SHB
    Shengzhen Ping An Bank SPABANK
    Shanghai Pudong Development Bank SPDB
    Yinlian Bank YLB

    For COP currency:

    Bank Name Bank Code
    Bancolombia PC

    For IDR currency:

    Bank Name Bank Code
    ALTO, Prima, ATM Bersama ATMVA
    Bank Central Asia BCA_IDR
    Bank Rakyat Indonesia BRI_IDR
    Bank Negara Indonesia BNI_IDR
    BTN Bank BTN_IDR
    CIMB Clicks Indonesia CIMB_IDR
    Danamon Bank DMN_IDR
    Mandiri Bank MDR_IDR
    Permata Bank PMB_IDR
    Virtual Account Bank VA

    For INR currency:

    Bank Name Bank Code
    Netbanking NB
    UPI UI

    For MXN currency:

    Bank Name Bank Code
    Spei SE
    Banorte BQ

    For MYR currency:

    Bank Name Bank Code
    7-eleven stores CASH-711
    Affin Bank FPX_ABB, AFFIN-EPG
    Alliance Bank FPX_ABMB
    Am Online FPX_AMB, AMB-W2W
    Bank Islam FPX_BIMB, BANKISLAM
    Bank Muamalat FPX_BMMB
    Bank Rakyat FPX_BKRM
    Bank Simpanan Nasional FPX_BSN
    CIMB Clicks Bank CIMB_MYR, FPX_CIMBCLICKS, CIMB-CLICKS
    FPX FPX
    HLB Connect FPX_HLB, HLB-ONL
    Hong Leong Bank HLE_MYR
    jmpay jompay.php
    Kuwait Finance House FPX_KFN
    May Bank MAY_MYR
    Maybank2u FPX_MB2U, MB2U
    OCBC Bank FPX_OCBC
    PBeBank FPX_PBB, PUBLICKBANK
    Public Bank PBE_MYR
    RHB Bank RHB_MYR
    RHB Now FPX_RHB, RHB-ONL
    Stand Chart Bank FPX_SCB
    UOB Bank FPX_UOB

    For PEN currency:

    Bank Name Bank Code
    BCP BC
    Interbank IB
    Pago Efectivo EF

    For PYG currency:

    Bank Name Bank Code
    PagoExpress PE

    For THB currency:

    Bank Name Bank Code
    Bangkok Bank BBL_THB, TH_PB_BBLPN
    Kasikorn Bank KKB_THB
    Krungsri (Bank of Ayudhya Public Company Limited) BAY_THB, TH_PB_BAYPN
    Krung Thai Bank KTB_THB, TH_PB_KTBPN
    OMISE_TL OMISE_TL.php
    Siam Commercial Bank SCB_THB, TH_PB_SCBPN
    UOBT UOB_THB

    For UYU currency:

    Bank Name Bank Code
    Abitab AI

    For PHP currency:

    Bank Name Bank Code
    Dragonpay DRAGONPAY

    For SGD currency:

    Bank Name Bank Code
    SG eNETS ENETS-D
    singpost singpost.php

    For VND currency:

    Bank Name Bank Code
    VTC-Pay VTCP_VPBANK
    VTC-Pay ABBANK VTCP_ABBANK
    VTC-Pay ACB VTCP_ACB
    VTC-Pay Agribank VTCP_AGRIBANK
    VTC-Pay BACABANK VTCP_BACABANK
    VTC-Pay BIDV VTCP_BIDV
    VTC-Pay BVB VTCP_BVB
    VTC-Pay DongABank VTCP_DONGABANK
    VTC-Pay Eximbank VTCP_EXIMBANK
    VTC-Pay GPBank VTCP_GPBANK
    VTC-Pay HDBank VTCP_HDBANK
    VTC-Pay LienVietPostBank VTCP_LVPB
    VTC-Pay MB VTCP_MB
    VTC-Pay MaritimeBank VTCP_MARITIMEBANK
    VTC-Pay NamABank VTCP_NAMABANK
    VTC-Pay Navibank VTCP_NAVIBANK
    VTC-Pay Oceanbank VTCP_OCEANBANK
    VTC-Pay PGBank VTCP_PGBANK
    VTC-Pay PHUONGDONG VTCP_PHUONGDONG
    VTC-Pay SHB VTCP_SHB
    VTC-Pay Sacombank VTCP_SACOMBANK
    VTC-Pay SaigonBank VTCP-SAIGON_BANK
    VTC-Pay SeaABank VTCP_SEAABANK
    VTC-Pay Techcombank VTCP_TECHCOMBANK
    VTC-Pay TienPhong Bank VTCP_TIENPHONGBANK
    VTC-Pay VIB VTCP_VIB
    VTC-Pay VietABank VTCP_VIETABANK
    VTC-Pay Vietcombank VTCP_VIETCOMBANK
    VTC-Pay Vietinbank VTCP_VIETINBANK

    Successful Response

    stdClass Object
(
    [transaction_type] => online_banking
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 50000
    [currency] => CNY
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>online_banking</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>50000</amount>
    <currency>CNY</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => online_banking
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [technical_message] => amount is missing
    [message] => Please check input data for errors!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 50000
    [currency] => CNY
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>online_banking</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <technical_message>amount is missing</technical_message>
    <message>Please check input data for errors!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>50000</amount>
    <currency>CNY</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    P24

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\P24');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.P24Request;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    P24Request request = new P24Request();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.p24(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "USD",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>p24</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: p24
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required* string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => p24
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[p24]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "p24",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:03Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>p24</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => p24
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:03.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[p24]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:03Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "p24",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:03Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>p24</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:03Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    PayU

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\PayU');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('PLN')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Krakov')
  ->setBillingCountry('PL')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payu</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>PLN</currency>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Krakov</city>
      <country>PL</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: payu
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email optional e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required string(255) Customer first name
       last_name required string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported currencies and countries:

    Currency code Country code
    CZK CZ
    PLN PL

    Successful Response

    stdClass Object
(
    [transaction_type] => payu
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => PLN
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payu</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>PLN</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => payu
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => PLN
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payu</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>PLN</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    POLi

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\POLi');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('AUD')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Sofia')
  ->setBillingCountry('AU')
  ->setBillingState('AC');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.POLiRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    POLiRequest request = new POLiRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setNotificationUrl(new URL("https://www.example.com/notification"));
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("AUD");


    // Billing Address
    request.setBillingFirstname("Barney");
    request.setBillingLastname("Rubble");
    request.setBillingPrimaryAddress("14, Nerazdelni str");
    request.setBillingZipCode("1407");
    request.setBillingCity("Sofia");
    request.setBillingCountry("AU");
    request.setBillingState("AC");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.poli(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "AUD",
    "billing_address": {
      "first_name": "Barney",
      "last_name": "Rubble",
      "address1": "14, Nerazdelni str",
      "zip_code": "1407",
      "city": "Sofia",
      "country": "AU",
      "state": "AC"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>poli</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>AUD</currency>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Sofia</city>
      <country>AU</country>
      <state>AC</state>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: poli
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported bank countries:

    Country name Country code
    Australia AU
    New Zealand NZ

    Supported currencies:

    Currency name Currency code
    Australian dollar AUD
    New Zealand dollar NZD

    Successful Response

    stdClass Object
(
    [transaction_type] => poli
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => AUD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[poli]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:04Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[AUD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "poli",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:04Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "AUD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>poli</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>AUD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => poli
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => AUD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[poli]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:04Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[AUD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "poli",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:04Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "AUD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>poli</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>AUD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    PSE (Pagos Seguros en Linea)

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\Pse');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rumble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Bogota')
  ->setBillingCountry('CO')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>pse</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Bogota</city>
      <country>CO</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: pse
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    CO

    Successful Response

    stdClass Object
(
    [transaction_type] => pse
    [status] => pending_async
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>pse</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => pse
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>pse</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    RapiPago

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\Rapipago');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rumble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Buenos Aires')
  ->setBillingCountry('AR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>rapi_pago</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Buenos Aires</city>
      <country>AR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: rapi_pago
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    AR

    Successful Response

    stdClass Object
(
    [transaction_type] => rapi_pago
    [status] => pending_async
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>rapi_pago</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => rapi_pago
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>rapi_pago</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    SafetyPay

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\SafetyPay');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setPaymentType('safetypay')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('')
  ->setNationalId('')
  ->setBirthDate('')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Tampico')
  ->setBillingCountry('MX')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>safetypay</transaction_type>
    <transaction_id>43671</transaction_id>
    <payment_type>safetypay</payment_type>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference nil="true"/>
    <national_id nil="true"/>
    <birth_date nil="true"/>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Tampico</city>
      <country>MX</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\PPRO');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setPaymentType('safetypay')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('')
  ->setNationalId('')
  ->setBirthDate('')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Tampico')
  ->setBillingCountry('MX')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.PProRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PProRequest request = new PProRequest();

    request.setTransactionId("43671");
    request.setPaymentType("safetypay");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setConsumerReference("");
    request.setNationalId("");
    request.setBirthDate("");
    request.setCustomerEmail("travis@example.com");


    // Billing Address
    request.setBillingFirstname("Barney");
    request.setBillingLastname("Rubble");
    request.setBillingPrimaryAddress("14, Nerazdelni str");
    request.setBillingZipCode("1407");
    request.setBillingCity("Tampico");
    request.setBillingCountry("MX");


    // Risk Params
    request.setRiskUserId("123456");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.ppro(
  {
    "transaction_id": "43671",
    "payment_type": "safetypay",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "USD",
    "consumer_reference": null,
    "national_id": null,
    "birth_date": null,
    "customer_email": "travis@example.com",
    "billing_address": {
      "first_name": "Barney",
      "last_name": "Rubble",
      "address1": "14, Nerazdelni str",
      "zip_code": "1407",
      "city": "Tampico",
      "country": "MX"
    },
    "risk_params": {
      "user_id": "123456"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <transaction_id>43671</transaction_id>
    <payment_type>safetypay</payment_type>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference nil="true"/>
    <national_id nil="true"/>
    <birth_date nil="true"/>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Tampico</city>
      <country>MX</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) ppro or safetypay. Contact tech support at tech-support@e-comprocessing.com for more details.
    transaction_id required string(255) Unique transaction id defined by merchant
    payment_type required1 safetypay SafetyPay. Contact tech support for more details
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    1 - payment_type must be submitted only when the transaction type is set to ppro

    Supported countries:

    Country
    AT
    BE
    BR
    CL
    CO
    CR
    DE
    EC
    ES
    MX
    NL
    PE
    PR

    Supported currencies:

    Currency Code
    EUR
    USD

    Successful Response

    stdClass Object
(
    [transaction_type] => safetypay
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>safetypay</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:04Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:04Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro/safetypay</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Santander

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\Santander');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rubble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Rio de Janeiro')
  ->setBillingCountry('BR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>santander</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Rio de Janeiro</city>
      <country>BR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: santander
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    AR
    BR

    Successful Response

    stdClass Object
(
    [transaction_type] => santander
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>santander</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => santander
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>santander</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    SDD Init Recurring Sale

    An SddInitRecurringSale transaction initializes a recurring payment and is equal to a normal SddSaleTransaction except that it can be referenced as ”initial” transaction in a SddRecurringSale transaction.

    Note that if an SddInitRecurringSale is fully refunded, the recurring series is stopped and no more SddRecurringSales can be performed for that recurring series.

    If an SddInitRecurringSale is partially refunded, the recurring series can continue with more SddRecurringSales.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\SDD\Recurring\InitRecurringSale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setIban('DE09100100101234567891')
  ->setBic('PBNKDEFFXXX')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingCountry('DE');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.sdd.SDDInitRecurringSaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SDDInitRecurringSaleRequest request = new SDDInitRecurringSaleRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");
    request.setIban("DE09100100101234567891");
    request.setBic("PBNKDEFFXXX");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingCountry("DE");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sdd_init_recurring_sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "EUR",
    "iban": "DE09100100101234567891",
    "bic": "PBNKDEFFXXX",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "country": "DE"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_init_recurring_sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>EUR</currency>
    <iban>DE09100100101234567891</iban>
    <bic>PBNKDEFFXXX</bic>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <country>DE</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: sdd_init_recurring_sale
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    iban required string(34) Customer’s IBAN number
    bic required string(11) SWIFT/BIC code of the customer’s bank
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required string(255) Customer first name
       last_name required string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country Name Country Code
    Austria AT
    Belgium BE
    Cyprus CY
    Estonia EE
    Finland FI
    France FR
    Germany DE
    Greece GR
    Ireland IE
    Italy IT
    Latvia LV
    Lithuania LT
    Luxembourg LU
    Malta MT
    Monaco MC
    Netherlands NL
    Portugal PT
    Slovakia SK
    San Marino SM
    Slovenia SI
    Spain ES

    Successful Response

    stdClass Object
(
    [transaction_type] => sdd_init_recurring_sale
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[sdd_init_recurring_sale]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:04Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "sdd_init_recurring_sale",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:04Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_init_recurring_sale</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => sdd_init_recurring_sale
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Please check input data for errors!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[sdd_init_recurring_sale]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Please check input data for errors!]>
    <timestamp content=[2019-09-17T15:39:04Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "sdd_init_recurring_sale",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Please check input data for errors!",
    timestamp: "2019-09-17T15:39:04Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_init_recurring_sale</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Please check input data for errors!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    SDD Recurring Sale

    A SddRecurringSale transaction is a ”repeated” transaction which follows and references a SddInitRecurringSale transaction.

    The bank account data is omitted.

    Note that SddRecurringSales can be partially or fully refunded if configuration allows it, and this will not stop the sdd recurring series.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\SDD\Recurring\RecurringSale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setReferenceId('2ee4287e67971380ef7f97d5743bb523');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.sdd.SDDRecurringSaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SDDRecurringSaleRequest request = new SDDRecurringSaleRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");
    request.setReferenceId("2ee4287e67971380ef7f97d5743bb523");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sdd_recurring_sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "EUR",
    "reference_id": "2ee4287e67971380ef7f97d5743bb523"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_recurring_sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>EUR</currency>
    <reference_id>2ee4287e67971380ef7f97d5743bb523</reference_id>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: sdd_recurring_sale
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required string(32) Unique id returned by corresponding transaction
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => sdd_recurring_sale
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[sdd_recurring_sale]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:04Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "sdd_recurring_sale",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:04Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_recurring_sale</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => sdd_recurring_sale
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 320
    [technical_message] => amount is missing!
    [message] => Please check input data for errors!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
)

    <payment_response content=[
    <transaction_type content=[sdd_recurring_sale]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[320]>
    <technical_message content=[amount is missing!]>
    <message content=[Please check input data for errors!]>
    <timestamp content=[2019-09-17T15:39:04Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
]>

    {
    transaction_type: "sdd_recurring_sale",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "320",
    technical_message: "amount is missing!",
    message: "Please check input data for errors!",
    timestamp: "2019-09-17T15:39:04Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_recurring_sale</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>320</code>
    <technical_message>amount is missing!</technical_message>
    <message>Please check input data for errors!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    SDD Refund

    SddRefunds allow to return already billed amounts to customers.

    The amount can be fully refunded only, no partial refunds are allowed. Note that SDD refunds can only be done on former approved SDD transactions

    Therefore, the reference_id for the corresponding transaction is mandatory.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\SDD\Refund');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setReferenceId('2ee4287e67971380ef7f97d5743bb523');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.sdd.SDDRefundRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SDDRefundRequest request = new SDDRefundRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");
    request.setReferenceId("2ee4287e67971380ef7f97d5743bb523");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sdd_refund(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "amount": "100",
    "currency": "EUR",
    "reference_id": "2ee4287e67971380ef7f97d5743bb523"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_refund</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <amount>100</amount>
    <currency>EUR</currency>
    <reference_id>2ee4287e67971380ef7f97d5743bb523</reference_id>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: sdd_refund
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required string(255) Description of the transaction for later use
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    reference_id required string(32) Unique id returned by corresponding transaction

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => sdd_refund
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[sdd_refund]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:04Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "sdd_refund",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:04Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_refund</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => sdd_refund
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 320
    [technical_message] => amount is missing!
    [message] => Please check input data for errors!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:04.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[sdd_refund]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[320]>
    <technical_message content=[amount is missing!]>
    <message content=[Please check input data for errors!]>
    <timestamp content=[2019-09-17T15:39:04Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "sdd_refund",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "320",
    technical_message: "amount is missing!",
    message: "Please check input data for errors!",
    timestamp: "2019-09-17T15:39:04Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_refund</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>320</code>
    <technical_message>amount is missing!</technical_message>
    <message>Please check input data for errors!</message>
    <timestamp>2019-09-17T15:39:04Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    SDD Sale

    The status of Sepa Direct Debit transactions is not available right after a transaction is made. Merchants receive the status of SDD transaction at 8:30 am (CET), 10:30 am (CET), 3:30 pm (CET) and 7:30 pm (CET). The merchant should have enabled notifications

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\SDD\Sale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setIban('DE09100100101234567891')
  ->setBic('PBNKDEFFXXX')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingCountry('DE');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.sdd.SDDSaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SDDSaleRequest request = new SDDSaleRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");
    request.setIban("DE09100100101234567891");
    request.setBic("PBNKDEFFXXX");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingCountry("DE");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sdd_sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "EUR",
    "iban": "DE09100100101234567891",
    "bic": "PBNKDEFFXXX",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "country": "DE"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>EUR</currency>
    <iban>DE09100100101234567891</iban>
    <bic>PBNKDEFFXXX</bic>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <country>DE</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: sdd_sale
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    iban required string(34) Customer’s IBAN number
    bic required string(11) SWIFT/BIC code of the customer’s bank
    billing_address required See Required vs Optional API params for details
       first_name required string(255) Customer first name
       last_name required string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    *Supported countries: *

    The supported countries are the same as SDD Init Recurring Sale.

    Successful Response

    stdClass Object
(
    [transaction_type] => sdd_sale
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[sdd_sale]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:05Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "sdd_sale",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:05Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_sale</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => sdd_sale
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [message] => expiration_year is invalid
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[sdd_sale]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <message content=[expiration_year is invalid]>
    <timestamp content=[2019-09-17T15:39:05Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "sdd_sale",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "340",
    message: "expiration_year is invalid",
    timestamp: "2019-09-17T15:39:05Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sdd_sale</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <message>expiration_year is invalid</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Sofort

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\Sofort');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Berlin')
  ->setBillingCountry('DE');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.SofortRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SofortRequest request = new SofortRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");
    request.setCustomerEmail("travis@example.com");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Berlin");
    request.setBillingCountry("DE");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sofort(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "EUR",
    "customer_email": "travis@example.com",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Berlin",
      "country": "DE"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sofort</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Berlin</city>
      <country>DE</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: sofort
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    customer_bank_id optional string(12) The bank id of the bank where the cutomer resides
    bank_account_number optional string(24) Bank identification number of the customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country name Country code
    Austria AT
    Belgium BE
    France FR
    Germany DE
    Italy IT
    Netherlands NL
    Poland PL
    Spain ES
    Switzerland CH
    United Kingdom GB

    Successful Response

    stdClass Object
(
    [transaction_type] => sofort
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[sofort]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:05Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "sofort",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:05Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sofort</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => sofort
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[sofort]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:05Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "sofort",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:05Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sofort</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Trustly Sale

    Trustly is an oBeP-style alternative payment method that allows you to pay directly with your ebank account.

    It has two transaction types sale and withdrawal. After initiating a transaction Trustly will redirect you to their page.

    There you have to select your bank and log in with your regular access codes. Choose the account from which you wish to pay (for example, your savings account or current account).

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\Trustly\Sale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setPaymentType('')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Max')
  ->setBillingLastName('Mustermann')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Berlin')
  ->setBillingCountry('DE');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.TrustlySaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    TrustlySaleRequest request = new TrustlySaleRequest();

    request.setTransactionId("43671");
    request.setPaymentType("");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setNotificationUrl(new URL("https://www.example.com/notification"));
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");
    request.setCustomerEmail("travis@example.com");


    // Billing Address
    request.setBillingFirstname("Max");
    request.setBillingLastname("Mustermann");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Berlin");
    request.setBillingCountry("DE");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.trustly_sale(
  {
    "transaction_id": "43671",
    "payment_type": null,
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "EUR",
    "customer_email": "travis@example.com",
    "billing_address": {
      "first_name": "Max",
      "last_name": "Mustermann",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Berlin",
      "country": "DE"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>trustly_sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <payment_type nil="true"/>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Max</first_name>
      <last_name>Mustermann</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Berlin</city>
      <country>DE</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: trustly_sale
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country name Country code
    Austria AT
    Belgium BE
    Bulgaria BG
    Croatia HR
    Czech Republic CZ
    Denmark DK
    Estonia EE
    Finland FI
    Germany DE
    Greece GR
    Hungary HU
    Ireland IE
    Italy IT
    Latvia LV
    Lithuania LT
    Netherlands NL
    Norway NO
    Poland PL
    Portugal PT
    Romania RO
    Slovakia SK
    Slovenia SI
    Spain ES
    Sweden SE
    United Kingdom GB

    Successful Response

    stdClass Object
(
    [transaction_type] => trustly_sale
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[trustly_sale]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:05Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "trustly_sale",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:05Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>trustly_sale</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => trustly_sale
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[trustly_sale]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:05Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "trustly_sale",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:05Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>trustly_sale</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    TrustPay

    TrustPay is a real-time bank transfer payment service, which is widely used in the Czech Republic and Slovakia.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>trustpay</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Prague</city>
      <country>CZ</country>
    </billing_address>
  </payment_transaction>'

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\PPRO');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setPaymentType('trustpay')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('EUR')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Prague')
  ->setBillingCountry('CZ');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.PProRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PProRequest request = new PProRequest();

    request.setTransactionId("43671");
    request.setPaymentType("trustpay");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");


    // Billing Address
    request.setBillingFirstname("Barney");
    request.setBillingLastname("Rubble");
    request.setBillingPrimaryAddress("14, Nerazdelni str");
    request.setBillingZipCode("1407");
    request.setBillingCity("Prague");
    request.setBillingCountry("CZ");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.ppro(
  {
    "transaction_id": "43671",
    "payment_type": "trustpay",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "EUR",
    "billing_address": {
      "first_name": "Barney",
      "last_name": "Rubble",
      "address1": "14, Nerazdelni str",
      "zip_code": "1407",
      "city": "Prague",
      "country": "CZ"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <transaction_id>43671</transaction_id>
    <payment_type>trustpay</payment_type>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>EUR</currency>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Prague</city>
      <country>CZ</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) ppro or trustpay. Contact tech support at tech-support@e-comprocessing.com for more details.
    transaction_id required string(255) Unique transaction id defined by merchant
    payment_type required1 ppro TrustPay. Contact tech support at tech-support@e-comprocessing.com for more details.
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    1 - payment_type must be submitted only when the transaction type is set to ppro

    Supported countries

    Country code
    CZ
    SK

    Supported currencies

    Currency code
    CZK
    EUR

    Successful Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:05Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:05Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => ppro
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[ppro]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:05Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "ppro",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:05Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ppro</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Webpay

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>webpay</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>john_doe</consumer_reference>
    <national_id>8812128812</national_id>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: webpay
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries

    Country Name Country code
    Chile CL

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Davivienda

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>davivienda</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>barney@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Bogota</city>
      <country>CO</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: davivienda
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    CO

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>davivienda</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>davivienda</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Cash Payments

    Baloto

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\CashPayments\Baloto');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rubble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Bogota')
  ->setBillingCountry('CO')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>baloto</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Bogota</city>
      <country>CO</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: baloto
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    CO

    Successful Response

    stdClass Object
(
    [transaction_type] => baloto
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>baloto</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => baloto
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>baloto</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Banamex

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\CashPayments\Banamex');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rubble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Monterrey')
  ->setBillingCountry('MX')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>banamex</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Monterrey</city>
      <country>MX</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: banamex
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National Identifier number of the customer
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    MX

    Successful Response

    stdClass Object
(
    [transaction_type] => banamex
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>banamex</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => banamex
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>banamex</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Banco de Occidente

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\CashPayments\BancoDeOccidente');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Bogota')
  ->setBillingCountry('CO')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>banco_de_occidente</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Bogota</city>
      <country>CO</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: banco_de_occidente
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    CO

    Successful Response

    stdClass Object
(
    [transaction_type] => banco_de_occidente
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>banco_de_occidente</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => banco_de_occidente
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>banco_de_occidente</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Boleto

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\CashPayments\Boleto');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rubble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Rio de Janeiro')
  ->setBillingCountry('BR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>boleto</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Rio de Janeiro</city>
      <country>BR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: boleto
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    BR

    Successful Response

    stdClass Object
(
    [transaction_type] => boleto
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>boleto</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => boleto
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:05.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>boleto</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:05Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Efecty

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\CashPayments\Efecty');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rumble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('barney@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Bogota')
  ->setBillingCountry('CO')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>efecty</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>barney@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Bogota</city>
      <country>CO</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: efecty
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    CO

    Successful Response

    stdClass Object
(
    [transaction_type] => efecty
    [status] => pending_async
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>efecty</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => efecty
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>efecty</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    OXXO

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\CashPayments\Oxxo');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rumble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('barney@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Mexico City')
  ->setBillingCountry('MX')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>oxxo</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>barney@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Mexico City</city>
      <country>MX</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: oxxo
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    MX

    Successful Response

    stdClass Object
(
    [transaction_type] => oxxo
    [status] => pending_async
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>oxxo</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => oxxo
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>oxxo</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Pago Facil

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\CashPayments\PagoFacil');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rumble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('barney@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Buenos Aires')
  ->setBillingCountry('AR')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>pago_facil</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rumble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>barney@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Buenos Aires</city>
      <country>AR</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: pago_facil
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    AR

    Successful Response

    stdClass Object
(
    [transaction_type] => pago_facil
    [status] => pending_async
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>pago_facil</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => pago_facil
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>pago_facil</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Redpagos

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\CashPayments\Redpagos');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rubble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Montevideo')
  ->setBillingCountry('UY')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>redpagos</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Montevideo</city>
      <country>UY</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: redpagos
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National ID of the consumer. See Document ID Parameter for more details.
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    UY

    Successful Response

    stdClass Object
(
    [transaction_type] => redpagos
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>redpagos</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => redpagos
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>redpagos</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Santander Cash

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\CashPayments\SantanderCash');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerReference('barney_rubble')
  ->setNationalId('8812128812')
  ->setBirthDate('30-12-1992')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Barney')
  ->setBillingLastName('Rubble')
  ->setBillingAddress1('14, Nerazdelni str')
  ->setBillingZipCode('1407')
  ->setBillingCity('Tampico')
  ->setBillingCountry('MX')


  // Risk Params
  ->setRiskUserId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>santander_cash</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_reference>barney_rubble</consumer_reference>
    <national_id>8812128812</national_id>
    <birth_date>30-12-1992</birth_date>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Tampico</city>
      <country>MX</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: santander_cash
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    consumer_reference required string(20) Consumer reference is a unique consumer identifier
    national_id required string(20) National Identifier number of the customer
    birth_date optional string(20) Birth date of the customer
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country
    MX

    Successful Response

    stdClass Object
(
    [transaction_type] => santander_cash
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>santander_cash</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => santander_cash
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>santander_cash</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Gift Cards

    Intersolve

    Intersolve transactions are made using gift card provided by Intersolve

    Using an intersolve transaction, the amount is immediately billed to the customer’s gift card.

    It can be reversed via a void transaction. Intersolve gift cards also support payout.

    Use intersolve transactions if you are using gift cards provided by Intersolve.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\GiftCards\Intersolve');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardNumber('7000001163991388834')
  ->setCvv('944062')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.giftcards.IntersolveRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    IntersolveRequest request = new IntersolveRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardNumber("7000001163991388834");
    request.setCvv("944062");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>intersolve</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_number>7000001163991388834</card_number>
    <cvv>944062</cvv>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: intersolve
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required* string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_number required string(19..21) Gift card number
    cvv required* 5 to 8 digits Verification code of the gift card, requirement is based on terminal configuration
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted. Cannot be set together with remember_card
    remember_card optional "true" See Tokenize. Tokenizes cardholder parameters. Cannot be set together with token
    consumer_id optional string(10) See Consumers and Tokenization. Combine with remember_card to tokenize or with token to use token
    billing_address required* See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => intersolve
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[intersolve]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>intersolve</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    consumer_id string(10) Consumer unique reference. See Consumers
    token string(36) Plain-text token value. See Tokenization
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Error Response

    stdClass Object
(
    [transaction_type] => intersolve
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => Transaction_id is invalid!
    [message] => Transaction_id is invalid!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[intersolve]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[Transaction_id is invalid!]>
    <message content=[Transaction_id is invalid!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>intersolve</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>Transaction_id is invalid!</technical_message>
    <message>Transaction_id is invalid!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Fashioncheque

    Fashioncheque transactions are made using gift card provided by Fashioncheque

    Using a fashioncheque transaction, the amount is immediately billed to the customer’s gift card.

    It can be reversed via a void transaction on the same day of the transaction. They can also be refunded.

    Use fashioncheque transactions, if you are using gift cards provided by Fashioncheque.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\GiftCards\Fashioncheque');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardNumber('6046425117120757123')
  ->setCvv('121839')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.giftcards.FashionchequeRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    FashionchequeRequest request = new FashionchequeRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardNumber("6046425117120757123");
    request.setCvv("121839");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>fashioncheque</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_number>6046425117120757123</card_number>
    <cvv>121839</cvv>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: fashioncheque
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required* string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Only USD and EUR
    card_number required string(19..21) Gift card number
    cvv required* 5 to 8 digits Verification code of the gift card, requirement is based on terminal configuration
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted
    billing_address required* See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => fashioncheque
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[fashioncheque]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>fashioncheque</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Error Response

    stdClass Object
(
    [transaction_type] => fashioncheque
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => Transaction_id is invalid!
    [message] => Transaction_id is invalid!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[fashioncheque]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[Transaction_id is invalid!]>
    <message content=[Transaction_id is invalid!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>fashioncheque</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>Transaction_id is invalid!</technical_message>
    <message>Transaction_id is invalid!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    TCS

    The container store transactions are made using gift cards provided by TCS.

    The amount from a Container Store Transactions is immediately billed to the customer’s gift card.

    It can be reversed via a void transaction.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\GiftCards\Tcs');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardNumber('6046425117120757123')
  ->setCvv('121839')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.giftcards.TCSRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    TCSRequest request = new TCSRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardNumber("6046425117120757123");
    request.setCvv("121839");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>container_store</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_number>6046425117120757123</card_number>
    <cvv>121839</cvv>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: container_store
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required* string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Only USD and EUR
    card_number required string(19..21) Gift card number
    cvv required* 5 to 8 digits Verification code of the gift card, requirement is based on terminal configuration
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted
    billing_address required* See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => container_store
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[container_store]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>container_store</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Error Response

    stdClass Object
(
    [transaction_type] => container_store
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => Transaction_id is invalid!
    [message] => Transaction_id is invalid!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[container_store]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[Transaction_id is invalid!]>
    <message content=[Transaction_id is invalid!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>container_store</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>Transaction_id is invalid!</technical_message>
    <message>Transaction_id is invalid!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Split Payments

    Split payments are performed on gift card transaction types when there isn’t enough balance in the gift card. In order to use split payments you need to enable them on terminal. For more information please contact tech support.

    Split payments follow this workflow:

    Example for initial split payment transaction:

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\GiftCards\Fashioncheque');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('5000')
  ->setCurrency('EUR')
  ->setCardNumber('6046425117120757123')
  ->setCvv('121839')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.giftcards.FashionchequeRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    FashionchequeRequest request = new FashionchequeRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(5000));
    request.setCurrency("EUR");
    request.setCardNumber("6046425117120757123");
    request.setCvv("121839");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>fashioncheque</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>5000</amount>
    <currency>EUR</currency>
    <card_number>6046425117120757123</card_number>
    <cvv>121839</cvv>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: fashioncheque
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required* string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Only USD and EUR
    card_number required string(19..21) Gift card number
    cvv required* 5 to 8 digits Verification code of the gift card, requirement is based on terminal configuration
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted
    billing_address required* See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => fashioncheque
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 406bc1b340472db4dbbba4b749850234
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 2000
    [currency] => EUR
    [split_payment] => initiated
    [leftover_amount] => 3000
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[fashioncheque]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[406bc1b340472db4dbbba4b749850234]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[2000]>
    <currency content=[EUR]>
    <split_payment content=[initiated]>
    <leftover_amount content=[3000]>
    <sent_to_acquirer content=[true]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>fashioncheque</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>406bc1b340472db4dbbba4b749850234</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>2000</amount>
    <currency>EUR</currency>
    <split_payment>initiated</split_payment>
    <leftover_amount>3000</leftover_amount>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    split_payment string Split payment status for this transaction. Should be ’initiated’.
    leftover_amount integer Leftover amount of transaction in minor currency unit, see Currency Handling for details
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Error Response

    stdClass Object
(
    [transaction_type] => fashioncheque
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => Transaction_id is invalid!
    [message] => Transaction_id is invalid!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 5000
    [currency] => EUR
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[fashioncheque]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[Transaction_id is invalid!]>
    <message content=[Transaction_id is invalid!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5000]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[false]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>fashioncheque</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>Transaction_id is invalid!</technical_message>
    <message>Transaction_id is invalid!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5000</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Example for continued split payment transaction:

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\GiftCards\Intersolve');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReferenceId('406bc1b340472db4dbbba4b749850234')
  ->setAmount('3000')
  ->setCurrency('EUR')
  ->setCardNumber('7000001163991388834')
  ->setCvv('944062')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.giftcards.IntersolveRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    IntersolveRequest request = new IntersolveRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReferenceId("406bc1b340472db4dbbba4b749850234");
    request.setAmount(new BigDecimal(3000));
    request.setCurrency("EUR");
    request.setCardNumber("7000001163991388834");
    request.setCvv("944062");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>intersolve</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>406bc1b340472db4dbbba4b749850234</reference_id>
    <amount>3000</amount>
    <currency>EUR</currency>
    <card_number>7000001163991388834</card_number>
    <cvv>944062</cvv>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: intersolve
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required* string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required string(32) The ’unique id’ of the initial split payment transaction.
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_number required string(19..21) Gift card number
    cvv required* 5 to 8 digits Verification code of the gift card, requirement is based on terminal configuration
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted
    billing_address required* See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => intersolve
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 2500
    [currency] => EUR
    [split_payment] => continued
    [leftover_amount] => 500
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[intersolve]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[2500]>
    <currency content=[EUR]>
    <split_payment content=[continued]>
    <leftover_amount content=[500]>
    <sent_to_acquirer content=[true]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>intersolve</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>2500</amount>
    <currency>EUR</currency>
    <split_payment>continued</split_payment>
    <leftover_amount>500</leftover_amount>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    split_payment string Split payment status for this transaction. Should be ’continued’.
    leftover_amount integer Leftover amount of transaction in minor currency unit, see Currency Handling for details
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Error Response

    stdClass Object
(
    [transaction_type] => intersolve
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => Transaction_id is invalid!
    [message] => Transaction_id is invalid!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 3000
    [currency] => EUR
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[intersolve]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[Transaction_id is invalid!]>
    <message content=[Transaction_id is invalid!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[3000]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[false]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>intersolve</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>Transaction_id is invalid!</technical_message>
    <message>Transaction_id is invalid!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>3000</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Example for finalized split payment transaction:

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\GiftCards\Intersolve');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReferenceId('406bc1b340472db4dbbba4b749850234')
  ->setAmount('500')
  ->setCurrency('EUR')
  ->setCardNumber('7000001163991388834')
  ->setCvv('944062')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.giftcards.IntersolveRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    IntersolveRequest request = new IntersolveRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReferenceId("406bc1b340472db4dbbba4b749850234");
    request.setAmount(new BigDecimal(500));
    request.setCurrency("EUR");
    request.setCardNumber("7000001163991388834");
    request.setCvv("944062");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>intersolve</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>406bc1b340472db4dbbba4b749850234</reference_id>
    <amount>500</amount>
    <currency>EUR</currency>
    <card_number>7000001163991388834</card_number>
    <cvv>944062</cvv>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: intersolve
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required* string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required string(32) The ’unique id’ of the initial split payment transaction.
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_number required string(19..21) Gift card number
    cvv required* 5 to 8 digits Verification code of the gift card, requirement is based on terminal configuration
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted
    billing_address required* See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => intersolve
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 500
    [currency] => EUR
    [split_payment] => finalized
    [leftover_amount] => 0
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[intersolve]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[500]>
    <currency content=[EUR]>
    <split_payment content=[finalized]>
    <leftover_amount content=[0]>
    <sent_to_acquirer content=[true]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>intersolve</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>500</amount>
    <currency>EUR</currency>
    <split_payment>finalized</split_payment>
    <leftover_amount>0</leftover_amount>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    split_payment string Split payment status for this transaction. Should be ’finalized’.
    leftover_amount integer Leftover amount of transaction in minor currency unit, see Currency Handling for details
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Error Response

    stdClass Object
(
    [transaction_type] => intersolve
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => Transaction_id is invalid!
    [message] => Transaction_id is invalid!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:06.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 500
    [currency] => EUR
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[intersolve]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[Transaction_id is invalid!]>
    <message content=[Transaction_id is invalid!]>
    <timestamp content=[2019-09-17T15:39:06Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[500]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[false]>
]>

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>intersolve</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>Transaction_id is invalid!</technical_message>
    <message>Transaction_id is invalid!</message>
    <timestamp>2019-09-17T15:39:06Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>500</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Example for finalized Sale split payment transaction:

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReferenceId('406bc1b340472db4dbbba4b749850234')
  ->setAmount('500')
  ->setCurrency('EUR')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReferenceId("406bc1b340472db4dbbba4b749850234");
    request.setAmount(new BigDecimal(500));
    request.setCurrency("EUR");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "reference_id": "406bc1b340472db4dbbba4b749850234",
    "amount": "500",
    "currency": "EUR",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>406bc1b340472db4dbbba4b749850234</reference_id>
    <amount>500</amount>
    <currency>EUR</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: sale
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    gaming optional "true" Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required* string(32) The ’unique id’ of the initial split payment transaction
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_holder required string(255) Full name of customer as printed on credit card (first name and last name at least)
    card_number required 13 to 16 digits Complete cc number of customer
    cvv required* 3 to 4 digits cvv of cc, requirement is based on terminal configuration
    expiration_month required MM Expiration month as printed on credit card
    expiration_year required YYYY Expiration year as printed on credit card
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    birth_date required* dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => sale
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 345678
    [response_code] => 00
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 500
    [currency] => EUR
    [split_payment] => finalized
    [leftover_amount] => 0
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[sale]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:07Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[500]>
    <currency content=[EUR]>
    <split_payment content=[finalized]>
    <leftover_amount content=[0]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "sale",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "345678",
    response_code: "00",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:07Z",
    descriptor: "Descriptor one",
    amount: "500",
    currency: "EUR",
    split_payment: "finalized",
    leftover_amount: "0",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>500</amount>
    <currency>EUR</currency>
    <split_payment>finalized</split_payment>
    <leftover_amount>0</leftover_amount>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    split_payment string Split payment status for this transaction. Should be ’finalized’.
    leftover_amount integer Leftover amount of transaction in minor currency unit, see Currency Handling for details
    sent_to_acquirer string "true" or "false"
    partial_approval string(4) Optional, set to ’true’ if partial approval happened. Partially approved amount is then in the amount field. Check Partial Approvals for details
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Error Response

    stdClass Object
(
    [response_code] => 57
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => billing_address[zip_code] is invalid!
    [message] => billing_address[zip_code] is invalid!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 500
    [currency] => EUR
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <response_code content=[57]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[billing_address[zip_code] is invalid!]>
    <message content=[billing_address[zip_code] is invalid!]>
    <timestamp content=[2019-09-17T15:39:07Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[500]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[false]>
]>

    {
    response_code: "57",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "340",
    technical_message: "billing_address[zip_code] is invalid!",
    message: "billing_address[zip_code] is invalid!",
    timestamp: "2019-09-17T15:39:07Z",
    descriptor: "Descriptor one",
    amount: "500",
    currency: "EUR",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <response_code>57</response_code>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>billing_address[zip_code] is invalid!</technical_message>
    <message>billing_address[zip_code] is invalid!</message>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>500</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Example for finalized Sale 3D split payment transaction:

    Asynchronous Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale3D');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReferenceId('406bc1b340472db4dbbba4b749850234')
  ->setAmount('500')
  ->setCurrency('EUR')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4711100000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // MPI Asynchronous
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success.html')
  ->setReturnFailureUrl('http://www.example.com/failure.html');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.Sale3DRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    Sale3DRequest request = new Sale3DRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReferenceId("406bc1b340472db4dbbba4b749850234");
    request.setAmount(new BigDecimal(500));
    request.setCurrency("EUR");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4711100000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Mpi Asynchronous
    request.setNotificationUrl("https://www.example.com/notification");
    request.setReturnSuccessUrl("http://www.example.com/success.html");
    request.setReturnFailureUrl("http://www.example.com/failure.html");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale3d(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "reference_id": "406bc1b340472db4dbbba4b749850234",
    "amount": "500",
    "currency": "EUR",
    "card_holder": "Travis Pastrana",
    "card_number": "4711100000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success.html",
    "return_failure_url": "http://www.example.com/failure.html"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale3d</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>406bc1b340472db4dbbba4b749850234</reference_id>
    <amount>500</amount>
    <currency>EUR</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4711100000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <mpi_asynchronous>
      <notification_url>https://www.example.com/notification</notification_url>
      <return_success_url>http://www.example.com/success.html</return_success_url>
      <return_failure_url>http://www.example.com/failure.html</return_failure_url>
    </mpi_asynchronous>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: sale3d
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    gaming optional "true" Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required string(32) The ’unique id’ of the initial split payment transaction
    notification_url required1 url URL at merchant where gateway sends outcome of transaction.
    return_success_url required1 url URL where customer is sent to after successful payment
    return_failure_url required1 url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_holder required string(255) Full name of customer as printed on credit card (first name and last name at least)
    card_number required 13 to 16 digits Complete cc number of customer
    cvv required 3 to 4 digits cvv of cc, requirement is based on terminal configuration
    expiration_month required MM Expiration month as printed on credit card
    expiration_year required YYYY Expiration year as printed on credit card
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    birth_date required* dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    mpi_params required2
       cavv required3 string(255) Verification Id of the authentication. Please note this can be the CAVV for Visa Card or UCAF to identify MasterCard.
       eci required3 string(255) See Electronic Commerce Indicator as returned from the MPI for details
       xid required3 string(255) Transaction ID generated by the 3D Secure service that uniquely identifies a 3D Secure check request
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number

    required* = conditionally required

    1 - required if mpi_params is not present, transaction will be handled asynchronous.

    2 - required if transaction should be handled synchronous.

    3 - eci is always required if mpi_params is present. xid and cavv are not required for the 3D attempted only workflow, where the merchant does not have the xid/cavv, only the eci.

    Successful Asynchronous Response

    stdClass Object
(
    [transaction_type] => sale3d
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 500
    [currency] => EUR
    [split_payment] => finalized
    [leftover_amount] => 0
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[sale3d]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <timestamp content=[2019-09-17T15:39:07Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[500]>
    <currency content=[EUR]>
    <split_payment content=[finalized]>
    <leftover_amount content=[0]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "sale3d",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    timestamp: "2019-09-17T15:39:07Z",
    descriptor: "Descriptor one",
    amount: "500",
    currency: "EUR",
    split_payment: "finalized",
    leftover_amount: "0",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale3d</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>500</amount>
    <currency>EUR</currency>
    <split_payment>finalized</split_payment>
    <leftover_amount>0</leftover_amount>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    partial_approval string(4) Optional, set to ’true’ if partial approval happened. Partially approved amount is then in the amount field. Check Partial Approvals for details
    split_payment string Split payment status for this transaction. Should be ’finalized’.
    leftover_amount integer Leftover amount of transaction in minor currency unit, see Currency Handling for details
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Error Response

    stdClass Object
(
    [transaction_type] => sale3d
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 57
    [code] => 340
    [technical_message] => expiration_year is invalid
    [message] => expiration_year is invalid
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 500
    [currency] => EUR
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[sale3d]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <response_code content=[57]>
    <code content=[340]>
    <technical_message content=[expiration_year is invalid]>
    <message content=[expiration_year is invalid]>
    <timestamp content=[2019-09-17T15:39:07Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[500]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "sale3d",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    response_code: "57",
    code: "340",
    technical_message: "expiration_year is invalid",
    message: "expiration_year is invalid",
    timestamp: "2019-09-17T15:39:07Z",
    descriptor: "Descriptor one",
    amount: "500",
    currency: "EUR",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale3d</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code>57</response_code>
    <code>340</code>
    <technical_message>expiration_year is invalid</technical_message>
    <message>expiration_year is invalid</message>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>500</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Voiding of split payments:

    Split Payment Timeouts:

    Invoice Payment Methods

    Alternative payments refer to payment methods that are used as an alternative to credit card payments.

    Each alternative payment method has its own unique application, settlement process and currency support.

    Klarna Authorize

    With Klarna Authorize transactions, you can confirm that an order is successful.

    After settling the transaction (e.g. shipping the goods), you should use klarna capture transaction type to capture the amount.

    Klarna authorize transaction will automatically be cancelled after a certain time frame, most likely two weeks.

    For a typical e-commerce application it is recommended to authorize the amount on incoming orders and capture it when shipping the goods.

    If you choose not to serve the customer, consider to void the klarna authorize to cancel the initial transaction.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\Klarna\Authorize');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setReturnCancelUrl('http://www.example.com/cancel')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('60')
  ->setCurrency('USD')
  ->setCustomerPhone('+1987987987987')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerGender('male')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // Shipping Address
  ->setShippingFirstName('Travis')
  ->setShippingLastName('Pastrana')
  ->setShippingAddress1('Muster Str. 12')
  ->setShippingZipCode('10001')
  ->setShippingCity('Los Angeles')
  ->setShippingState('CA')
  ->setShippingCountry('US');

// Klarna Items
$items = new \Genesis\API\Request\Financial\Alternatives\Klarna\Items('USD');
$item  = new \Genesis\API\Request\Financial\Alternatives\Klarna\Item();
$item
  ->setItemType('physical')
  ->setReference('19-402-USA')
  ->setName('BatteryPowerPack')
  ->setQuantity('1')
  ->setUnitPrice('60')
  ->setTaxRate('0')
  ->setTotalAmount('60')
  ->setTotalDiscountAmount('0')
  ->setTotalTaxAmount('0')
  ->setImageUrl('https://example.com/image_url')
  ->setProductUrl('https://example.com/product_url')
  ->setQuantityUnit('pcs')
  ->addMerchantMarketplaceSellerInfo('Electronic gadgets')
$items->addItem($item);

$request->setItems($items);

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>klarna_authorize</transaction_type>
    <transaction_id>43671</transaction_id>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <return_cancel_url>http://www.example.com/cancel</return_cancel_url>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>60</amount>
    <currency>USD</currency>
    <customer_phone>+1987987987987</customer_phone>
    <customer_email>travis@example.com</customer_email>
    <customer_gender>male</customer_gender>
    <order_tax_amount>0</order_tax_amount>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <shipping_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10001</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </shipping_address>
    <items>
      <item>
        <item_type>physical</item_type>
        <reference>19-402-USA</reference>
        <name>BatteryPowerPack</name>
        <quantity>1</quantity>
        <unit_price>60</unit_price>
        <tax_rate>0</tax_rate>
        <total_amount>60</total_amount>
        <total_discount_amount>0</total_discount_amount>
        <total_tax_amount>0</total_tax_amount>
        <image_url>https://example.com/image_url</image_url>
        <product_url>https://example.com/product_url</product_url>
        <quantity_unit>pcs</quantity_unit>
        <merchant_data>
          <marketplace_seller_info>Electronic gadgets</marketplace_seller_info>
        </merchant_data>
      </item>
    </items>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: klarna_authorize
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    customer_gender optional Customer gender
    order_tax_amount required Non-negative, minor units. The total tax amount of the order
    items required List with items
       item_type required string(255) Order line type. Possible values: Supported item types
       quantity required integer Non-negative. The item quantity
       unit_price required integer Minor units. Includes tax, excludes discount(max value: 100000000)
       total_amount required integer Includes tax and discount. Must match (quantity unit price) - total discount amount divided by quantity (max value: 100000000)
       reference optional string(255) Article number, SKU or similar
       name optional string(255) Descriptive item name
       tax_rate optional integer Non-negative. In percent, two implicit decimals. I.e 2500 = 25.00 percent
       total_discount_amount optional integer Non-negative minor units. Includes tax
       total_tax_amount optional integer Must be within 1 of total amount - total_amount * 10000 / (10000 + tax rate). Negative when type is discount
       image_url optional url URL to an image that can be later embedded in communications between Klarna and the customer. (max 1024 characters)
       product_url optional url URL to an image that can be later embedded in communications between Klarna and the customer. (max 1024 characters)
       quantity_unit optional string(8) Unit used to describe the quantity, e.g. kg, pcs... If defined has to be 1-8 characters
       product_identifiers optional List with product identifiers
          brand optional string(255) The product's brand name as generally recognized by consumers. If no brand is available for a product, do not supply any value
          category_path optional string(255) The product's category path as used in the merchant's webshop. Include the full and most detailed category and separate the segments with ' > '
          global_trade_item_number optional string(255) The product's Global Trade Item Number (GTIN). Common types of GTIN are EAN, ISBN or UPC. Exclude dashes and spaces, where possible
          manufacturer_part_number optional string(255) The product's Manufacturer Part Number (MPN), which - together with the brand - uniquely identifies a product. Only submit MPNs assigned by a manufacturer and use the most specific MPN possible
       merchant_data optional List with merchant data
          marketplace_seller_info optional string(255) Information for merchant marketplace

    required* = conditionally required

    Supported countries:

    Country Country code
    Austria AT
    Denmark DK
    Finland FI
    Germany DE
    Netherlands NL
    Norway NO
    Sweden SE

    Supported item types:

    Item Types
    physical
    discount
    shipping fee
    sales tax
    digital
    gift card
    store credit
    surcharge

    Successful Response

    stdClass Object
(
    [transaction_type] => klarna_authorize
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 60
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>klarna_authorize</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>60</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => klarna_authorize
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 60
    [currency] => USD
    [sent_to_acquirer] => false
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>klarna_authorize</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>60</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    sent_to_acquirer string "true" or "false"

    Klarna Capture

    Klarna capture settles a Klarna transaction.

    Do this when you are shipping goods, for example. A Klarna capture can only be used after a Klarna Authorize on the same transaction.

    Therefore, the reference_id of the Klarna transaction is mandatory.

    Transaction workflow:

    1. The merchant sends Klarna transaction to the gateway.
    2. The gateway replies to it. One of returned values is the unique id of the transaction.
    3. The merchant sends Klarna capture transaction. Its reference id is unique id of Klarna response.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\Klarna\Capture');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReferenceId('43672')
  ->setAmount('60')
  ->setCurrency('USD');

// Klarna Items
$items = new \Genesis\API\Request\Financial\Alternatives\Klarna\Items('USD');
$item  = new \Genesis\API\Request\Financial\Alternatives\Klarna\Item();
$item
  ->setItemType('physical')
  ->setReference('19-402-USA')
  ->setName('BatteryPowerPack')
  ->setQuantity('1')
  ->setUnitPrice('60')
  ->setTaxRate('0')
  ->setTotalAmount('60')
  ->setTotalDiscountAmount('0')
  ->setTotalTaxAmount('0')
  ->setImageUrl('https://example.com/image_url')
  ->setProductUrl('https://example.com/product_url')
  ->setQuantityUnit('pcs')
  ->addMerchantMarketplaceSellerInfo('Electronic gadgets')
$items->addItem($item);

$request->setItems($items);

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>klarna_capture</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>43672</reference_id>
    <amount>60</amount>
    <currency>USD</currency>
    <items>
      <item>
        <item_type>physical</item_type>
        <reference>19-402-USA</reference>
        <name>BatteryPowerPack</name>
        <quantity>1</quantity>
        <unit_price>60</unit_price>
        <tax_rate>0</tax_rate>
        <total_amount>60</total_amount>
        <total_discount_amount>0</total_discount_amount>
        <total_tax_amount>0</total_tax_amount>
        <image_url>https://example.com/image_url</image_url>
        <product_url>https://example.com/product_url</product_url>
        <quantity_unit>pcs</quantity_unit>
        <merchant_data>
          <marketplace_seller_info>Electronic gadgets</marketplace_seller_info>
        </merchant_data>
      </item>
    </items>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: klarna_capture
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required string(32) Unique id returned by corresponding transaction
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    items required List with items
       item_type required string(255) Order line type. Possible values: Supported item types
       quantity required integer Non-negative. The item quantity
       unit_price required integer Minor units. Includes tax, excludes discount(max value: 100000000)
       total_amount required integer Includes tax and discount. Must match (quantity unit price) - total discount amount divided by quantity (max value: 100000000)
       reference optional string(255) Article number, SKU or similar
       name optional string(255) Descriptive item name
       tax_rate optional integer Non-negative. In percent, two implicit decimals. I.e 2500 = 25.00 percent
       total_discount_amount optional integer Non-negative minor units. Includes tax
       total_tax_amount optional integer Must be within 1 of total amount - total_amount * 10000 / (10000 + tax rate). Negative when type is discount
       image_url optional url URL to an image that can be later embedded in communications between Klarna and the customer. (max 1024 characters)
       product_url optional url URL to an image that can be later embedded in communications between Klarna and the customer. (max 1024 characters)
       quantity_unit optional string(8) Unit used to describe the quantity, e.g. kg, pcs... If defined has to be 1-8 characters
       product_identifiers optional List with product identifiers
          brand optional string(255) The product's brand name as generally recognized by consumers. If no brand is available for a product, do not supply any value
          category_path optional string(255) The product's category path as used in the merchant's webshop. Include the full and most detailed category and separate the segments with ' > '
          global_trade_item_number optional string(255) The product's Global Trade Item Number (GTIN). Common types of GTIN are EAN, ISBN or UPC. Exclude dashes and spaces, where possible
          manufacturer_part_number optional string(255) The product's Manufacturer Part Number (MPN), which - together with the brand - uniquely identifies a product. Only submit MPNs assigned by a manufacturer and use the most specific MPN possible
       merchant_data optional List with merchant data
          marketplace_seller_info optional string(255) Information for merchant marketplace

    required* = conditionally required

    Supported countries:

    Country Country code
    Austria AT
    Denmark DK
    Finland FI
    Germany DE
    Netherlands NL
    Norway NO
    Sweden SE

    Supported item types:

    Item Types
    physical
    discount
    shipping_fee
    sales_tax
    digital
    gift_card
    store_credit
    surcharge

    Successful Response

    stdClass Object
(
    [transaction_type] => klarna_capture
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 60
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>klarna_capture</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>60</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => klarna_capture
    [status] => error
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 60
    [currency] => USD
    [sent_to_acquirer] => false
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>klarna_capture</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>60</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    sent_to_acquirer string "true" or "false"

    Crypto

    Alternative payment methods supporting digital cryptocurrencies.

    BitPay Sale

    BitPay is a cryptocurrency payments provider supporting blockchain payments with Bitcoin (BTC) and BitcoinCash (BCH).

    BitPay Sale is an asynchronous transaction type.

    When this payment method is selected at checkout, the customer will be redirected to the BitPay system window including all the data for the payment: Bitcoin/BitcoinCash account, amount to be paid in cryptocurrency and the Fiat equivalent.

    If the customer possesses a BitPay wallet or another BitPay compatible crypto wallet, the payment can be done from that window with one click, otherwise a QR CODE containing all the payment data can be scanned and used in any crypto wallet.

    Then the customer has 15 minutes to fulfill the generated invoice.

    If that timeframe is not met, the invoice will expire and the Merchant will be notified.

    If the invoice is fulfilled in the timeframe, it needs to obtain 6 blockchain confirmations (1 hour) before it’s safe for the payment to be considered as completed.

    At that point, the Merchant will be notified for the approved payment.

    After the 6th confirmation, when the transaction is completed, the Merchant can process a refund if it’s needed.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Crypto\BitPay\Sale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnUrl('https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f')
  ->setAmount('3000')
  ->setCurrency('EUR')
  ->setCustomerEmail('travis@example.com')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Berlin')
  ->setBillingCountry('DE');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bitpay_sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/a55ab44d242f</return_url>
    <amount>3000</amount>
    <currency>EUR</currency>
    <customer_email>travis@example.com</customer_email>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Berlin</city>
      <country>DE</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: bitpay_sale
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip optional IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_url required url URL where consumer is sent to after payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    billing_address required* See Required vs Optional API params for details
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => bitpay_sale
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 3000
    [currency] => EUR
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bitpay_sale</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>3000</amount>
    <currency>EUR</currency>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => bitpay_sale
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [technical_message] => Something went wrong, please contact support!
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 3000
    [currency] => EUR
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bitpay_sale</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <technical_message>Something went wrong, please contact support!</technical_message>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>3000</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Payouts

    Bank Pay-out

    Bank Pay-out is a bank pay-out method. It allows merchants to transfer funds directly to customers’ bank accounts.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\OnlineBankingPayments\OnlineBanking\Payout');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('50000')
  ->setCurrency('INR')
  ->setCustomerPhone('+1987987987987')
  ->setCustomerEmail('travis@example.com')
  ->setBankName('Netbanking')
  ->setBankBranch('HDFC0000001')
  ->setBankAccountNumber('1234123412341234')
  ->setBankAccountName('Anurak Nghuen')
  ->setIdCardNumber('123789456')
  ->setPayerBankPhoneNumber('01234567891')


  // Billing Address
  ->setBillingFirstName('Anurak')
  ->setBillingLastName('Nghuen')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('New Delhi')
  ->setBillingState('New Delhi')
  ->setBillingCountry('IN');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bank_payout</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>50000</amount>
    <currency>INR</currency>
    <customer_phone>+1987987987987</customer_phone>
    <customer_email>travis@example.com</customer_email>
    <bank_name>Netbanking</bank_name>
    <bank_branch>HDFC0000001</bank_branch>
    <bank_account_number>1234123412341234</bank_account_number>
    <bank_account_name>Anurak Nghuen</bank_account_name>
    <id_card_number>123789456</id_card_number>
    <payer_bank_phone_number>01234567891</payer_bank_phone_number>
    <billing_address>
      <first_name>Anurak</first_name>
      <last_name>Nghuen</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>New Delhi</city>
      <state>New Delhi</state>
      <country>IN</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: bank_payout
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    notification_url required url URL at merchant where gateway sends outcome of transaction.
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    bank_name required bank name Must contain Bank Names
    bank_branch required* bank branch Name of the Bank branch
    bank_account_name required bank account name Bank account name is required, for CNY currency and should be in Simplified Chinese. For other currency, must be in English Language.
    bank_account_number required bank account number Bank account number of the customer.
    bank_province required* bank province Name of the province that the bank is located.
    id_card_number required* string(30) ID card number
    payer_bank_phone_number required* string(11) Payer bank phone number
    billing_address required See Required vs Optional API params for details
       first_name required string(255) Customer first name
       last_name required string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166

    required* = conditionally required

    Supported currencies

    Currency name Currency code
    China yen CNY
    Indonesian rupiah IDR
    Indian rupee INR
    Malaysian ringgit MYR
    Thai baht THB

    Bank Names

    For CNY currency:

    Bank Name
    中国银行
    中国交通银行
    中信银行
    上海浦发银行
    中国农业银行
    中国渤海银行
    上海银行
    中国工商银行
    东亚银行
    上海农商银行
    中国建设银行
    中国兴业银行
    平安银行
    广发银行
    北京农商银行
    宁波银行
    光大银行
    北京银行
    大连银行
    尧都农商银行
    徽商银行
    华夏银行
    南京银行
    广州银行
    浙商银行
    招商银行
    民生银行
    汉口银行
    晋商银行
    杭州银行
    深圳发展银行
    江苏银行
    成都银行
    珠海农商银行
    顺德农村商业银行
    中国邮政银行
    银联通道

    For MYR currency:

    Bank Name
    423
    CIMB Clicks Bank
    Hong Leong Bank
    May Bank
    Public Bank
    RHB Bank

    For THB currency:

    Bank Name
    Bangkok Bank
    Kasikorn Bank
    Krungsri (Bank of Ayudhya Public Company Limited)
    Krung Thai Bank
    Siam Commercial Bank
    UOBT

    For IDR currency:

    Bank Name
    Bank Central Asia
    Bank Rakyat Indonesia
    Bank Negara Indonesia
    BTN Bank
    CIMB Clicks Indonesia
    Danamon Bank
    Mandiri Bank
    Permata Bank

    For INR currency:

    Bank Name Bank Code
    Netbanking NB
    UPI UI

    Successful Response

    stdClass Object
(
    [transaction_type] => bank_payout
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 50000
    [currency] => INR
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bank_payout</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>50000</amount>
    <currency>INR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => bank_payout
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 50000
    [currency] => INR
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bank_payout</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>50000</amount>
    <currency>INR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    BitPay Payout

    BitPay Payout is a crypto currency payout method where merchants are requesting payouts in FIAT currency and the funds are transferred in Bitcoin equivalent to a crypto wallet address.

    BitPay Payout is an asynchronous transaction type supported through the Processing API, Virtual Terminal and Web Payment Form.

    The payout requests are processed once a day at 11:00 GMT and the settlement usually takes 24 hours.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Crypto\BitPay\Payout');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('2000')
  ->setCurrency('USD')
  ->setCryptoAddress('n1jE32b88mtT7UETWvV6WgrV5AUVTPDxW8')
  ->setCryptoWalletProvider('other')
  ->setCustomerEmail('travis@example.com');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bitpay_payout</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>2000</amount>
    <currency>USD</currency>
    <crypto_address>n1jE32b88mtT7UETWvV6WgrV5AUVTPDxW8</crypto_address>
    <crypto_wallet_provider>other</crypto_wallet_provider>
    <customer_email>travis@example.com</customer_email>
  </payment_transaction>'

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Crypto\BitPay\Payout');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('500000')
  ->setCurrency('USD')
  ->setCryptoAddress('n1jE32b88mtT7UETWvV6WgrV5AUVTPDxW7')
  ->setCryptoWalletProvider('kraken')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bitpay_payout</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>500000</amount>
    <currency>USD</currency>
    <crypto_address>n1jE32b88mtT7UETWvV6WgrV5AUVTPDxW7</crypto_address>
    <crypto_wallet_provider>kraken</crypto_wallet_provider>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: bitpay_payout
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    notification_url required url URL at merchant where gateway sends outcome of transaction.
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    customer_email required* e-mail address Must contain valid e-mail of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    crypto_address required string(255) Valid crypto address where the funds will be received
    crypto_wallet_provider required string(255) If crypto wallet provider is not in the table below, you must send ’other’
    billing_address required* See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Crypto wallet providers with additional requirements

    crypto wallet provider description website
    BitGo crypto wallet provider official website
    Uphold crypto wallet provider official website
    Circle crypto exchange official website
    Coinbase crypto wallet provider official website
    GDax crypto exchange official website
    Gemini crypto exchange official website
    ITBit crypto exchange official website
    Kraken crypto exchange official website

    Successful Response

    stdClass Object
(
    [transaction_type] => bitpay_payout
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 500000
    [currency] => USD
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bitpay_payout</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>500000</amount>
    <currency>USD</currency>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Error Response

    stdClass Object
(
    [transaction_type] => bitpay_payout
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 
    [code] => 940
    [technical_message] => Bitcoin address is invalid
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 2000
    [currency] => USD
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bitpay_payout</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code nil="true"/>
    <code>940</code>
    <technical_message>Bitcoin address is invalid</technical_message>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>2000</amount>
    <currency>USD</currency>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    eZeeCard Payout

    eZeeCard Payout is a sync based payout method. It's merchant initiated and can only reference specific transaction types:

    Those need to have been completed using a card issued by our Issuing API.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ezeecard_payout</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>1000</amount>
    <currency>EUR</currency>
    <reference_id>43672</reference_id>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: ezeecard_payout
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    reference_id required string(32) Unique id returned by corresponding transaction

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ezeecard_payout</transaction_type>
    <status>approved</status>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <transaction_id>43671</transaction_id>
    <mode>live</mode>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <amount>1000</amount>
    <currency>EUR</currency>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    transaction_id string(255) Unique transaction id defined by merchant
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>ezeecard_payout</transaction_type>
    <status>error</status>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <transaction_id>43671</transaction_id>
    <technical_message>invalid deposit transaction</technical_message>
    <message nil="true"/>
    <mode>live</mode>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <amount>1000</amount>
    <currency>EUR</currency>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    transaction_id string(255) Unique transaction id defined by merchant
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Payout

    Payouts are credits without a reference transaction and as such are highly regulated and need specific gateway terminal configuration, so be sure to contact the IT Support team at tech-support@e-comprocessing.com in case you want Payouts to be enabled. A valid bank account number needs to be provided.

    Using a payout, the amount is billed to the customer’s credit card. It can be reversed via a void transaction on the same day of the transaction.

    Both Visa and Mastercard/Maestro Payouts are authorized real-time.

    Note that for exceptional cases with some countries Visa OCTS will not be authorized through the schemes but batched for offline settlement on the same day. This means that the authorization code and issuer response code will not be available only for them.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Payout');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.PayoutRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PayoutRequest request = new PayoutRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.payout(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payout</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: payout
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    gaming optional "true" Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    card_holder required string(255) Full name of customer as printed on credit card (first name and last name at least)
    card_number required 13 to 16 digits Complete cc number of customer
    cvv required* 3 to 4 digits cvv of cc, requirement is based on terminal configuration
    expiration_month required MM Expiration month as printed on credit card
    expiration_year required YYYY Expiration year as printed on credit card
    token optional string(36) See Tokenization for more details. If present, the cardholder parameters can be omitted. Cannot be set together with remember_card
    remember_card optional "true" See Tokenize. Tokenizes cardholder parameters. Cannot be set together with token
    consumer_id optional string(10) See Consumers and Tokenization. Combine with remember_card to tokenize or with token to use token
    source_of_funds optional string Specify the source of funds with one of credit, debit, prepaid, cash, other_debit_account, other_credit_account.
    credential_on_file required* See Credential On File (COF) for more details
       initial_customer_initiated required* string(18) Initial transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       subsequent_customer_initiated required* string(18) Subsequent transaction initiated by customer. Required for external tokenization, and optional for gateway-based tokenization
       merchant_unscheduled optional string(20) Transaction is initiated by the merchant
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    birth_date required* dd-mm-yyyy Required when MCC is a Financial Services one (e.g. MCC 6012) and either card brand is Visa or Mastercard/Maestro with UK-based merchant, UK-based bin (domestic), and DEBIT card type
    document_id required* sring(20) Document ID of the consumer. See Document ID Parameter for more details.
    fx_rate_id optional integer See Get rates for FX Service. Offers the option to use a specific FX rate to convert the transaction processing amount. Used FX rate should have the same source currency as the processing currency. Contact tech-support@e-comprocessing.com for more details.
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => payout
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [consumer_id] => 123456
    [token] => ee946db8-d7db-4bb7-b608-b65b153e127d
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 345678
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[payout]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <consumer_id content=[123456]>
    <token content=[ee946db8-d7db-4bb7-b608-b65b153e127d]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <timestamp content=[2019-09-17T15:39:07Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "payout",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    consumer_id: "123456",
    token: "ee946db8-d7db-4bb7-b608-b65b153e127d",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "345678",
    response_code: "00",
    timestamp: "2019-09-17T15:39:07Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payout</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <consumer_id>123456</consumer_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    consumer_id string(10) Consumer unique reference. See Consumers
    token string(36) Plain-text token value. See Tokenization
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => payout
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 57
    [code] => 340
    [technical_message] => billing_address[zip_code] is invalid!
    [message] => billing_address[zip_code] is invalid!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:07.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[payout]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <response_code content=[57]>
    <code content=[340]>
    <technical_message content=[billing_address[zip_code] is invalid!]>
    <message content=[billing_address[zip_code] is invalid!]>
    <timestamp content=[2019-09-17T15:39:07Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "payout",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    response_code: "57",
    code: "340",
    technical_message: "billing_address[zip_code] is invalid!",
    message: "billing_address[zip_code] is invalid!",
    timestamp: "2019-09-17T15:39:07Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payout</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code>57</response_code>
    <code>340</code>
    <technical_message>billing_address[zip_code] is invalid!</technical_message>
    <message>billing_address[zip_code] is invalid!</message>
    <timestamp>2019-09-17T15:39:07Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Money transfer Payout

    Money transfer payout is a standard payout with additional parameters. The section and parameters below are optional and to be considered only when present.

    Money transfers: account_to_account, person_to_person, wallet_transfer.

    The transaction is not a result of a business operation but rather a pure funds movement from one account (card or non-card) to another (card).

    Bear in mind that the sender of the funds in this case is not a merchant, but a consumer.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Payout');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')
  ->setMoneyTransfer('{"type"=>"account_to_account", "sender_account_number"=>"DE91100000000123456789", "sender_address"=>{"first_name"=>"John", "last_name"=>"Smith", "country"=>"JoDEhn", "city"=>"Berlin", "zip_code"=>"10115", "address1"=>"1 Kaiserdamm Blvd, Berlin"}}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.PayoutRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PayoutRequest request = new PayoutRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");
    request.setMoneyTransfer("{"type"=>"account_to_account", "sender_account_number"=>"DE91100000000123456789", "sender_address"=>{"first_name"=>"John", "last_name"=>"Smith", "country"=>"JoDEhn", "city"=>"Berlin", "zip_code"=>"10115", "address1"=>"1 Kaiserdamm Blvd, Berlin"}}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.payout(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "money_transfer": {
      "type": "account_to_account",
      "sender_account_number": "DE91100000000123456789",
      "sender_address": {
        "first_name": "John",
        "last_name": "Smith",
        "country": "JoDEhn",
        "city": "Berlin",
        "zip_code": "10115",
        "address1": "1 Kaiserdamm Blvd, Berlin"
      }
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payout</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <money_transfer>
      <type>account_to_account</type>
      <sender_account_number>DE91100000000123456789</sender_account_number>
      <sender_address>
        <first_name>John</first_name>
        <last_name>Smith</last_name>
        <country>JoDEhn</country>
        <city>Berlin</city>
        <zip_code>10115</zip_code>
        <address1>1 Kaiserdamm Blvd, Berlin</address1>
      </sender_address>
    </money_transfer>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    money_transfer optional Money transfer Parameters
       type required string The type of money transfer. It can be account_to_account, person_to_person, wallet_transfer
       sender_account_number required string(33) Sender account number
       sender_address required
          first_name required string(255) Sender first name
          last_name required string(255) Sender last name
          country required string(2) Sender Country code in ISO 3166
          city required string(255) Sender City
          zip_code required string Sender ZIP code
          address1 required string(255) Sender Primary address
          state required* string(2) Sender State code in ISO 3166-2, required for USA and Canada

    required* = conditionally required

    Money transfer is supported only by Visa.

    Different money transfer types are allowed for specific merchant category codes (MCCs).

    Money transfer type Merchant category codes
    account_to_account 4829, 6012
    person_to_person 4829, 6012
    wallet_transfer 4829

    Successful Response

    stdClass Object
(
    [transaction_type] => payout
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
)

    <payment_response content=[
    <transaction_type content=[payout]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <response_code content=[]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
]>

    {
    transaction_type: "payout",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    response_code: "",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payout</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code nil="true"/>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    Error Response

    stdClass Object
(
    [transaction_type] => payout
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => money_transfer_type is not supported. Please select one of account_to_account, person_to_person, wallet_transfer
    [message] => Please check input data for errors!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
)

    <payment_response content=[
    <transaction_type content=[payout]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[money_transfer_type is not supported. Please select one of account_to_account, person_to_person, wallet_transfer]>
    <message content=[Please check input data for errors!]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
]>

    {
    transaction_type: "payout",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "340",
    technical_message: "money_transfer_type is not supported. Please select one of account_to_account, person_to_person, wallet_transfer",
    message: "Please check input data for errors!",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payout</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>money_transfer_type is not supported. Please select one of account_to_account, person_to_person, wallet_transfer</technical_message>
    <message>Please check input data for errors!</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    Non-money transfer Payout

    Non-money transfer payout is a standard payout with additional parameters. The section and parameters below are optional and to be considered only when present.

    Non-money transfer types are: b2b_supplier, loyalty, funds_disbursment, merchant_settlement, prepaid_card_load.

    The transaction is a result of a business operation.

    Bear in mind that the sender of the funds in this case is a merchant.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Payout');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')
  ->setMoneyTransfer('{"type"=>"loyalty"}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.PayoutRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    PayoutRequest request = new PayoutRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");
    request.setMoneyTransfer("{"type"=>"loyalty"}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.payout(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "money_transfer": {
      "type": "loyalty"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payout</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <money_transfer>
      <type>loyalty</type>
    </money_transfer>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    money_transfer optional Non-money transfer Parameters
       type required string The type of non-money transfer. It can be b2b_supplier, loyalty, funds_disbursment, merchant_settlement, prepaid_card_load

    required* = conditionally required

    Non-money transfer is supported only by Visa.

    The listed non-money transfer types are allowed for all merchant category codes (MCCs).

    Non-money transfer type
    b2b_supplier
    loyalty
    funds_disbursment
    merchant_settlement
    prepaid_card_load

    Successful Response

    stdClass Object
(
    [transaction_type] => payout
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [response_code] => 
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
)

    <payment_response content=[
    <transaction_type content=[payout]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <response_code content=[]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
]>

    {
    transaction_type: "payout",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    response_code: "",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payout</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <response_code nil="true"/>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    Error Response

    stdClass Object
(
    [transaction_type] => payout
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => money_transfer_type is not supported. Please select one of b2b_supplier, loyalty, funds_disbursment, merchant_settlement, prepaid_card_load
    [message] => Please check input data for errors!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
)

    <payment_response content=[
    <transaction_type content=[payout]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[money_transfer_type is not supported. Please select one of b2b_supplier, loyalty, funds_disbursment, merchant_settlement, prepaid_card_load]>
    <message content=[Please check input data for errors!]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
]>

    {
    transaction_type: "payout",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "340",
    technical_message: "money_transfer_type is not supported. Please select one of b2b_supplier, loyalty, funds_disbursment, merchant_settlement, prepaid_card_load",
    message: "Please check input data for errors!",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>payout</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>money_transfer_type is not supported. Please select one of b2b_supplier, loyalty, funds_disbursment, merchant_settlement, prepaid_card_load</technical_message>
    <message>Please check input data for errors!</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    SCT Payout

    SCT payouts are Sepa-based payouts to consumers done without a reference transaction and as such are regulated and need specific gateway terminal configuration, so be sure to contact the IT Support team at tech-support@e-comprocessing.com) in case you want SCT payouts to be enabled.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\SDD\Payout');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('EUR')
  ->setIban('DE09100100101234567891')
  ->setBic('PBNKDEFFXXX')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingCountry('DE');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.sdd.SDDPayoutRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SDDPayoutRequest request = new SDDPayoutRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("EUR");
    request.setIban("DE09100100101234567891");
    request.setBic("PBNKDEFFXXX");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingCountry("DE");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sct_payout(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "EUR",
    "iban": "DE09100100101234567891",
    "bic": "PBNKDEFFXXX",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "country": "DE"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sct_payout</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>EUR</currency>
    <iban>DE09100100101234567891</iban>
    <bic>PBNKDEFFXXX</bic>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <country>DE</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    iban required string(34) Customer’s IBAN number
    bic required string(11) SWIFT/BIC code of the customer’s bank
    billing_address required See Required vs Optional API params for details
       first_name required string(255) Customer first name
       last_name required string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: sct_payout
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    iban required string(34) Customer’s IBAN number
    bic required string(11) SWIFT/BIC code of the customer’s bank
    billing_address required See Required vs Optional API params for details
       first_name required string(255) Customer first name
       last_name required string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Allowed countries include supported countries for SDD Init Recurring Sale and the list below:

    Country Name Country Code
    Bulgaria BG
    Croatia HR
    Czech Republics CZ
    Denmark DK
    United Kingdom UK
    Hungary HU
    Iceland IS
    Liechtenstein LI
    Norway NO
    Poland PL
    Romania RO
    Sweden SE
    Switzerland CH

    Successful Response

    stdClass Object
(
    [transaction_type] => sct_payout
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[sct_payout]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "sct_payout",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sct_payout</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => sct_payout
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 340
    [technical_message] => expiration_year is invalid
    [message] => expiration_year is invalid
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => EUR
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[sct_payout]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[340]>
    <technical_message content=[expiration_year is invalid]>
    <message content=[expiration_year is invalid]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[EUR]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "sct_payout",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "340",
    technical_message: "expiration_year is invalid",
    message: "expiration_year is invalid",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "EUR",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sct_payout</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>340</code>
    <technical_message>expiration_year is invalid</technical_message>
    <message>expiration_year is invalid</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Trustly Withdrawal

    Trustly Withdrawal is an oBeP-style alternative payment method that allows you to transfer money directly to your customers ebank account.

    After initiating a transaction Trustly will redirect the customer to their page.

    There they have to select their bank and log in with their regular access codes.

    Then the customer has to choose the account where they wish to receive the payment (for example, their savings account or current account).

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Alternatives\Trustly\Withdrawal');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')
  ->setBirthDate('21-10-1980')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('12114')
  ->setBillingCity('Berlin')
  ->setBillingCountry('DE');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.apm.TrustlyWithdrawalRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    TrustlyWithdrawalRequest request = new TrustlyWithdrawalRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");
    request.setBirthDate("21-10-1980");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("12114");
    request.setBillingCity("Berlin");
    request.setBillingCountry("DE");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.trustly_withdrawal(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "amount": "100",
    "currency": "USD",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "birth_date": "21-10-1980",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "12114",
      "city": "Berlin",
      "country": "DE"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>trustly_withdrawal</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <birth_date>21-10-1980</birth_date>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>12114</zip_code>
      <city>Berlin</city>
      <country>DE</country>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    birth_date required dd-mm-yyyy Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries:

    Country name Country code
    Austria AT
    Bulgaria BG
    Belgium BE
    Croatia HR
    Czech Republic CZ
    Cyprus CY
    Denmark DK
    Estonia EE
    Finland FI
    France FR
    Germany DE
    Greece GR
    Hungary HU
    Italy IT
    Ireland IE
    Lithuania LT
    Latvia LV
    Luxembourg LU
    Malta MT
    Norway NO
    Netherlands NL
    Portugal PT
    Poland PL
    Romania RO
    Slovakia SK
    Slovenia SI
    Sweden SE
    Spain ES
    United Kingdom GB

    Successful Response

    stdClass Object
(
    [transaction_type] => trustly_withdrawal
    [status] => pending_async
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [redirect_url] => https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[trustly_withdrawal]>
    <status content=[pending_async]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <redirect_url content=[https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "trustly_withdrawal",
    status: "pending_async",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    redirect_url: "https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>trustly_withdrawal</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    redirect_url url URL where user has to be redirected to complete payment process. It is available for asynchronous mode
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => trustly_withdrawal
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 110
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[trustly_withdrawal]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[110]>
    <message content=[Something went wrong, please contact support!]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "trustly_withdrawal",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "110",
    message: "Something went wrong, please contact support!",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>trustly_withdrawal</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>110</code>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    African Mobile Payout

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>african_mobile_payout</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>KES</currency>
    <customer_email>barney.rubble@example.com</customer_email>
    <customer_phone>254701123456</customer_phone>
    <operator>SAFARICOM</operator>
    <target>000010</target>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Nairobi</city>
      <country>KE</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: african_mobile_payout
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required* string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    operator required string(20) Name of the Mobile network operator (MNO) which should process the transaction
    target required string(20) Number of the Paybill for which the transaction is intended
    customer_phone required string(32) Must contain valid phone number of customer
    customer_email required* e-mail address Must contain valid e-mail of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries, currencies, operators and payment method:

    Country code Currency code Operator Payment method
    GH GHS AIRTEL Airtel Money
    GH GHS MTN MTN Mobile Money
    GH GHS TIGO Tigo Cash
    GH GHS VODACOM M-PESA
    KE KES AIRTEL Airtel Money
    KE KES SAFARICOM M-PESA
    MZ MZN MOVITEL e-Mola
    MZ MZN VODACOM M-PESA
    RW RWF MTN MTN Mobile Money
    RW RWF TIGO Tigo Cash
    TZ TZS AIRTEL Airtel Money
    TZ TZS TIGO Tigo Cash
    TZ TZS VODACOM M-PESA
    UG UGX AIRTEL Airtel Money
    UG UGX MTN MTN Mobile Money

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>african_mobile_payout</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>KES</currency>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>african_mobile_payout</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <message>Something went wrong, please contact support!</message>
    <technical_message>operator is not supported!</technical_message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>KES</currency>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    message string(255) Human readable error message which can be displayed to users.
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    TransferTo Payout

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>transfer_to_payout</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>Funding</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>USD</currency>
    <customer_email>barney.rubble@example.com</customer_email>
    <payer_id>7</payer_id>
    <bank_account_number>0842024000</bank_account_number>
    <billing_address>
      <last_name>Rubble</last_name>
    </billing_address>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: transfer_to_payout
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    customer_email required e-mail address Must contain valid e-mail of customer
    payer_id required string ID of the Payer used to deliver the money through one of the 3 services
    bank_account_number required* string Bank identification number of the customer. *Requirement based on the Payer
    ifs_code required* ifsc Bank code of the bank in which the consumer resides. *Requirement based on the Payer
    msisdn required* msisdn Number uniquely identifying a subscription in a Global System. *Requirement based on the Payer
    billing_address required See Required vs Optional API params for details
       first_name optional string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported currencies:

    Currency
    EUR
    GBP
    HKD
    USD

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>transfer_to_payout</transaction_type>
    <status>pending_async</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>transfer_to_payout</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>910</code>
    <technical_message>Payer is currently unavailable</technical_message>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Mobile Payments

    African Mobile Sale

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>african_mobile_sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <amount>100</amount>
    <currency>KES</currency>
    <customer_email>barney.rubble@example.com</customer_email>
    <customer_phone>254701123456</customer_phone>
    <operator>SAFARICOM</operator>
    <target>000010</target>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Nairobi</city>
      <country>KE</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: african_mobile_sale
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    operator required string(20) Name of the Mobile network operator (MNO) which should process the transaction
    target required string(20) Number of the Paybill for which the transaction is intended
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required string(32) Must contain valid phone number of customer
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Supported countries, currencies, operators and payment method:

    Country code Currency code Operator Payment method
    GH GHS VODACOM M-PESA
    KE KES SAFARICOM M-PESA
    UG UGX AIRTEL Airtel Money
    UG UGX MTN MTN Mobile Money

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>african_mobile_sale</transaction_type>
    <status>pending_async</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>KES</currency>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>african_mobile_sale</transaction_type>
    <status>error</status>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <message>Something went wrong, please contact support!</message>
    <technical_message>operator is not supported</technical_message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>KES</currency>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    message string(255) Human readable error message which can be displayed to users.
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Reversals

    Reversal transactions serve to change the state of the original transaction and return money back to customer’s account. They can be used with Card, 3DS Card, and different APM transactions.

    Refund

    Refunds allow to return already billed amounts to customers.

    The amount can be fully or partially refunded. Refunds can only be done on former capture(settled) or sale transactions.

    Therefore, the reference id for the corresponding transaction is mandatory.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Refund');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReferenceId('43672')
  ->setAmount('100')
  ->setCurrency('USD');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.RefundRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    RefundRequest request = new RefundRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReferenceId("43672");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.refund(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "reference_id": "43672",
    "amount": "100",
    "currency": "USD"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>refund</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>43672</reference_id>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: refund
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required string(32) Unique id returned by corresponding transaction
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    beneficiary_bank_code required* string The bank code of the beneficiary's bank.
    beneficiary_name required* string The name of the beneficiary's bank.
    beneficiary_account_number required* string The account number of the beneficiary in his bank.

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => refund
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [authorization_code] => 345678
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
)

    <payment_response content=[
    <transaction_type content=[refund]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
]>

    {
    transaction_type: "refund",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    authorization_code: "345678",
    response_code: "00",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>refund</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Error Response

    stdClass Object
(
    [transaction_type] => refund
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 410
    [technical_message] => no approved reference transaction found
    [message] => no approved reference transaction found
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
)

    <payment_response content=[
    <transaction_type content=[refund]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[410]>
    <technical_message content=[no approved reference transaction found]>
    <message content=[no approved reference transaction found]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
]>

    {
    transaction_type: "refund",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "410",
    technical_message: "no approved reference transaction found",
    message: "no approved reference transaction found",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>refund</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>410</code>
    <technical_message>no approved reference transaction found</technical_message>
    <message>no approved reference transaction found</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    code integer Error code according to Error code table
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Void

    Void transactions undo other transactions.

    Transactions of types authorize, capture, sale, refund, recurring sale, and init recurring sale along with their 3D variants can be reversed on the same day the transaction took place. The transaction will not show up on the customer’s credit card statement if voided on the same day.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cancel');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReferenceId('43672');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.VoidRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    VoidRequest request = new VoidRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setReferenceId("43672");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.cancel(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "reference_id": "43672"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>void</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>43672</reference_id>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: void
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required string(32) Unique id returned by corresponding transaction

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => void
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [authorization_code] => 345678
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[void]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "void",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    authorization_code: "345678",
    response_code: "00",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>void</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => void
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 420
    [technical_message] => can not do void on void reference
    [message] => can not do void on void reference
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:08.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[void]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[420]>
    <technical_message content=[can not do void on void reference]>
    <message content=[can not do void on void reference]>
    <timestamp content=[2019-09-17T15:39:08Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[100]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "void",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "420",
    technical_message: "can not do void on void reference",
    message: "can not do void on void reference",
    timestamp: "2019-09-17T15:39:08Z",
    descriptor: "Descriptor one",
    amount: "100",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>void</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>420</code>
    <technical_message>can not do void on void reference</technical_message>
    <message>can not do void on void reference</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    code integer Error code according to Error code table
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Klarna Refund

    Klarna Refunds allow to return already billed amounts to customers.

    The amount can be fully or partially refunded. Klarna refunds can only be done on former Klarna Capture (settled) transactions.

    Therefore, the reference_id for the corresponding transaction is mandatory.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>klarna_refund</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>43672</reference_id>
    <amount>60</amount>
    <currency>USD</currency>
    <items>
      <item>
        <item_type>physical</item_type>
        <reference>19-402-USA</reference>
        <name>BatteryPowerPack</name>
        <quantity>1</quantity>
        <unit_price>60</unit_price>
        <tax_rate>0</tax_rate>
        <total_amount>60</total_amount>
        <total_discount_amount>0</total_discount_amount>
        <total_tax_amount>0</total_tax_amount>
        <image_url>https://example.com/image_url</image_url>
        <product_url>https://example.com/product_url</product_url>
        <quantity_unit>pcs</quantity_unit>
        <merchant_data>
          <marketplace_seller_info>Electronic gadgets</marketplace_seller_info>
        </merchant_data>
      </item>
    </items>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: klarna_refund
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required string(32) Unique id returned by corresponding transaction
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217
    items required List with items
       item_type required string(255) Order line type. Possible values: Supported item types
       quantity required integer Non-negative. The item quantity
       unit_price required integer Minor units. Includes tax, excludes discount(max value: 100000000)
       total_amount required integer Includes tax and discount. Must match (quantity unit price) - total discount amount divided by quantity (max value: 100000000)
       reference optional string(255) Article number, SKU or similar
       name optional string(255) Descriptive item name
       tax_rate optional integer Non-negative. In percent, two implicit decimals. I.e 2500 = 25.00 percent
       total_discount_amount optional integer Non-negative minor units. Includes tax
       total_tax_amount optional integer Must be within 1 of total amount - total_amount * 10000 / (10000 + tax rate). Negative when type is discount
       image_url optional url URL to an image that can be later embedded in communications between Klarna and the customer. (max 1024 characters)
       product_url optional url URL to an image that can be later embedded in communications between Klarna and the customer. (max 1024 characters)
       quantity_unit optional string(8) Unit used to describe the quantity, e.g. kg, pcs... If defined has to be 1-8 characters
       product_identifiers optional List with product identifiers
          brand optional string(255) The product's brand name as generally recognized by consumers. If no brand is available for a product, do not supply any value
          category_path optional string(255) The product's category path as used in the merchant's webshop. Include the full and most detailed category and separate the segments with ' > '
          global_trade_item_number optional string(255) The product's Global Trade Item Number (GTIN). Common types of GTIN are EAN, ISBN or UPC. Exclude dashes and spaces, where possible
          manufacturer_part_number optional string(255) The product's Manufacturer Part Number (MPN), which - together with the brand - uniquely identifies a product. Only submit MPNs assigned by a manufacturer and use the most specific MPN possible
       merchant_data optional List with merchant data
          marketplace_seller_info optional string(255) Information for merchant marketplace

    required* = conditionally required

    Supported item types:

    Item Types
    physical
    discount
    shipping_fee
    sales_tax
    digital
    gift_card
    store_credit
    surcharge

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>klarna_refund</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>60</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>klarna_refund</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>420</code>
    <technical_message>can not do void on void reference</technical_message>
    <message>can not do void on void reference</message>
    <timestamp>2019-09-17T15:39:08Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>60</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    BitPay Refund

    BitPay Refund is a custom refund method which will handle the asynchronous BitPay refund workflow. BitPay refunds can only be done on former transactions. Therefore, the reference id for the corresponding BitPay Sale transaction is mandatory.

    BitPay Refund is an asynchronous transaction type.

    When a BitPay Refund is requested, BitPay will send an email to the consumer with a request to provide the refund crypto address. This request will be valid for 3 days and will expire afterwards. When the crypto address is provided, the refund will be processed (processing usually takes 24 hours).

    A Notification will be sent to the Merchant when the Bitpay refund is completed.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Crypto\BitPay\Refund');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setReferenceId('43672')
  ->setAmount('100')
  ->setCurrency('USD');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bitpay_refund</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>43672</reference_id>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: bitpay_refund
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    reference_id required string(32) The reference_id must be a BitPay Sale transaction
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required string(3) Currency code in ISO 4217

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => bitpay_refund
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:09.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bitpay_refund</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Error Response

    stdClass Object
(
    [transaction_type] => bitpay_refund
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 410
    [technical_message] => no approved reference transaction found
    [message] => no approved reference transaction found
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:09.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 100
    [currency] => USD
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>bitpay_refund</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>410</code>
    <technical_message>no approved reference transaction found</technical_message>
    <message>no approved reference transaction found</message>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>100</amount>
    <currency>USD</currency>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    code integer Error code according to Error code table
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Partial Reversal

    Partial reversal transactions are used in the preauthorization workflow to release a part of the total authorized amount.

    PayByLink is a frictionless payment via link. It provides merchants the ability to send a payment link to a customer via email or SMS (configurable), using Virtual Terminal.

    Workflow

    The merchant can generate a PayByLink payment from the Virtual Terminal (if feature is enabled) by customizing an email template for sending payment link or configuring preferred medium (email/SMS) for sending payment link. When all the needed fields are filled in and the mandatory initial payload is provided, a payment request to the WPF is initiated. As a result of this request (if successful) the response would include redirect URL, which would be sent either via email or SMS to the customer (channel and needed email/phone number should be provided by the merchant when initiating the PayByLink payment). The customer can complete the payment by following the provided URL. It redirects to the merchant's web payment form (WPF) where the redirection workflows are the same as the ones described in the WPF section. The WPF reconcile API could also be used to check the status of any PayByLink initiated payment.

    Combination with Pay Later functionality

    The PayByLink triggered payments could be easily combined with the 'Pay Later' functionality (available also for the WPF API). The PayByLink form provides the ability to choose whether the customer would have the option enabled to delay the payment and complete it later. It also gives the ability of enqueuing reminders based on pre-configured values. The reminders include the URL for payment completion as well.

    Reminders configuration

    For configuration options or any other additional questions you can always contact Tech Support at tech-support@e-comprocessing.com.

    Alternative Payment Method External Events

    Introduction

    For some alternative payment method (APM) transactions additional events may occur resulting from various actions from the part of the consumer or the merchant. Examples: returned/reversed bank transfers, funds not received, additional bank transfers made using the same transaction reference number etc.

    In Genesis these are called external events and are handled in the following manner:

    1. A transaction note is created for the external event (visible under the ”Transaction Notes” section on the corresponding payment transaction page in the merchant console).
    2. An API notification is sent to the merchant notification endpoint
    3. An email notification is sent to the merchant admin email address
    4. The original transaction status might be updated depending on the nature of the external event

    List of external events per alternative payment method

    APM External event Description Status change
    InstaDebit Payin instadebit_payin_return Payment has been returned to the consumer voided
    InstaDebit Payin instadebit_payin_adjustment Payment has been adjusted none
    InstaDebit Payout instadebit_payout_return Payment has been returned to the consumer voided
    InstaDebit Payout instadebit_payout_adjustment Payment has been adjusted none
    iDebit Payin idebit_payin_return Payment has been returned to the consumer voided
    iDebit Payin idebit_payin_adjustment Payment has been adjusted none
    iDebit Payout idebit_payout_return Payment has been returned to the consumer voided
    iDebit Payout idebit_payout_adjustment Payment has been adjusted none
    P24 p24_external_refund Payment has been rescinded by the consumer or was never received refunded
    Argencard chargeback_external_event Payment has been considered fraudulent by the card issuer and was reversed chargebacked
    Aura chargeback_external_event Payment has been considered fraudulent by the card issuer and was reversed chargebacked
    Cabal chargeback_external_event Payment has been considered fraudulent by the card issuer and was reversed chargebacked
    Cencosud chargeback_external_event Payment has been considered fraudulent by the card issuer and was reversed chargebacked
    Elo chargeback_external_event Payment has been considered fraudulent by the card issuer and was reversed chargebacked
    Hipercard chargeback_external_event Payment has been considered fraudulent by the card issuer and was reversed chargebacked
    Naranja chargeback_external_event Payment has been considered fraudulent by the card issuer and was reversed chargebacked
    Nativa chargeback_external_event Payment has been considered fraudulent by the card issuer and was reversed chargebacked
    Tarjeta Shopping chargeback_external_event Payment has been considered fraudulent by the card issuer and was reversed chargebacked

    Email Notification

    An email is sent to the merchant admin’s email address detailing the external event type and any other relevant details together with a link to the original payment transaction.

    API Notification

    Merchants will receive API notifications every time Genesis obtains information about APM external events. Notifications are transmitted via HTTP POST (application/x-www-form-urlencoded) to the notification url endpoint provided in the XML request or to the Notification URL from the merchant account

    An example notification:

    &notification_type=apm_external_event
&signature=8216b1b4929c0a41ed44bf51726c10872a78f181b26d1427e15410da56803fc0a2f
&payment_transaction_unique_id=64216236bced683952325b6698b3954a
&category=citadel_payin_chargeback
&priority=info
&code=SDR
&info=Revoked+payment+due+to+instant+payment+funds+not+received
&message=A+Citadel+Payin+transaction+has+been+reversed%2Frevoked.+Payment+has+been+rescinded+by+the+consumer+or+funds+were+never+received+for+the+payment. 
&payload=...

    Parameters:

    Name Type Description
    notification_type string constant value ”apm external event”
    signature string the signature of the notification, should be used to verify the the notification was sent by Genesis
    payment_transaction_unique_id string unique id of the original transaction, generated by Genesis
    category string type of the external event
    priority string can be one of ”info”, ”normal” or ”urgent”
    code string code for the external event from the APM provider system
    info string a short description of the external event
    message string full short description of the external event
    payload string the raw response for the external event as received from the APM provider

    The signature is a security measure meant to ensure that the gateway is really the sender of the notification. It is generated by concatenating the unique id of the payment with your API password and generating a SHA-512 Hash (Hex) of the string:

    SHA-512 Hash Hex of [payment_transaction_unique_id][Your Merchant API password]

    Notification signature examples

    payment_transaction_unique_id API password signature
    26aa150ee68b1b2d6758a0e6c44fce4c 50fd87e65eb415f42fb5af4c9cf497662e00b785 c5219b3d385e74496b2b48a549
    3f760162ef57a829011e5e2379b3fa17 50fd87e65eb415f42fb5af4c9cf497662e00b785 14519d0db2f7f8f407efccc9b09 
    <?xml version="1.0" encoding="UTF-8"?>
<notification_echo>
  <unique_id>3f760162ef57a829011e5e2379b3fa17</unique_id>
</notification_echo>

    When receiving the notification, you are required to render an XML page containing the transaction’s payment transaction unique id so that the gateway knows that you have accepted the notification. If the XML is not delivered, the notification is sent periodically as per the rules for notifications delivery.

    Advanced risk management with RiskParams

    The risk params section in the payment transaction xml allows you to pass user specific values along with the payment transaction. These values may be used by advanced risk management features and checked against a blacklist.

    RiskParams can be used in any user triggered payment transaction. User triggered transactions types are Authorize, Authorize3d, Sale, Sale3d, InitRecurringSale, InitRecurringSale3d, and AccountVerification.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // Risk Params
  ->setRiskSsn('987-65-4320')
  ->setRiskMacAddress('12-34-56-78-9A-BC')
  ->setRiskSessionId('1DA53551-5C60-498C-9C18-8456BDBA74A9')
  ->setRiskUserId('1002547')
  ->setRiskUserLevel('vip')
  ->setRiskEmail('test@example.com')
  ->setRiskPhone('+49301234567')
  ->setRiskRemoteIp('245.253.2.12');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Risk Params
    request.setRiskSsn("987-65-4320");
    request.setRiskMacAddress("12-34-56-78-9A-BC");
    request.setRiskSessionId("1DA53551-5C60-498C-9C18-8456BDBA74A9");
    request.setRiskUserId("1002547");
    request.setRiskUserLevel("vip");
    request.setRiskEmail("test@example.com");
    request.setRiskPhone("+49301234567");
    request.setRiskRemoteIp("245.253.2.12");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "risk_params": {
      "ssn": "987-65-4320",
      "mac_address": "12-34-56-78-9A-BC",
      "session_id": "1DA53551-5C60-498C-9C18-8456BDBA74A9",
      "user_id": "1002547",
      "user_level": "vip",
      "email": "test@example.com",
      "phone": "+49301234567",
      "remote_ip": "245.253.2.12"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <risk_params>
      <ssn>987-65-4320</ssn>
      <mac_address>12-34-56-78-9A-BC</mac_address>
      <session_id>1DA53551-5C60-498C-9C18-8456BDBA74A9</session_id>
      <user_id>1002547</user_id>
      <user_level>vip</user_level>
      <email>test@example.com</email>
      <phone>+49301234567</phone>
      <remote_ip>245.253.2.12</remote_ip>
    </risk_params>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    risk_params optional
       ssn optional string(128) Social Security number or equivalent value for non US customers.
       mac_address optional string(128) The customers mac address.
       session_id optional string(128) The customers session_id.
       user_id optional string(128) The customers user_id.
       user_level optional string(128) A value describing the customers trust level, may be used by the risk management for configurable differentiated limits.
       email optional string(128) The customers email.
       phone optional string(128) The customers phone.
       remote_ip optional string(128) The customers ip address.
       serial_number optional string(128) Custom serial number.
       pan_tail optional string(128) The last 4 digits of the card number.
       bin optional string(128) The first 6 digits of the card number.
       first_name optional string(128) Customer first name.
       last_name optional string(128) Customer last name.
       country optional string(128) The country of the customer.
       pan optional string(128) The PAN hash of the customer card number.
       forwarded_ip optional string(128) MaxMind specific risk param.
       username optional string(128) MaxMind specific risk param.
       password optional string(128) MaxMind specific risk param.
       bin_name optional string(128) MaxMind specific risk param.
       bin_phone optional string(128) MaxMind specific risk param.

    required* = conditionally required

    To use these values for risk management please contact our Risk team.

    Credential On File (COF)

    As the payment ecosystem has evolved, instances in which a transaction is initiated with a stored credential based on cardholder consent for future use have significantly increased. Growth in digital commerce, together with the emergence of new business models, has increased the number of transactions where a merchant or its agent, a payment facilitator (PF), or a staged digital wallet operator (SDWO) uses cardholder payment credentials (i.e., account details) that they previously stored for future purchases.

    In Genesis, the COF indicator can be used for the following transaction types: Account Verification, Authorize, Authorize3D, Sale, Sale3D, InitRecurringSale, InitRecurringSale3D, Payout to mark a transaction as initial customer initiated, subsequent customer initiated or as unscheduled merchant initiated (UCOF).

    The UCOF transaction uses a previously stored credential for a fixed or variable amount and it does not occur on a scheduled or regularly occurring transaction date. With it, the cardholder has provided consent to the merchant to initiate one or more future transactions. An example of such a transaction is an account auto-top up.

    Supported options for Credential On File (COF) field:

    COF Description
    initial_customer_initiated Initial transaction used to store payment credentials for future customer initiated payments while processing. Required for external tokenization, and optional for gateway-based tokenization
    subsequent_customer_initiated Subsequent customer initiated transaction using previously stored payment credentials. Required for external tokenization, and optional for gateway-based tokenization
    merchant_unscheduled Merchant initiated transaction where the customer has given prior consent for the merchant to store and use payment credentials, UCOF transaction. For UCOF transaction in the request should be sent scheme transaction identifier of the initial transaction, used to store customer payment data.

    Currency and Amount Handling

    The gateway handles all types of processing currencies, with exponents ranging from 0 (e.g. JPY), 2 (e.g. CNY, USD, EUR, GBP), to 3 (e.g. KWD). Processing currencies are configured on terminal level.

    Transaction amounts on the API level should be submitted in the minor currency unit for the given currency, e.g.:

    Amount currencies:

    Name Type Description
    USD 100.33 Should be submitted as 10033 in the amount API field (exponent 2)
    EUR 3 Should be submitted as 300 in the amount API field (exponent 2)
    JPY 150 Should be submitted as 150 in the amount API field (exponent 0)
    KWD 100.333 Should be submitted as 100333 in the amount API field (exponent 3)

    Amount limits: Amount has to be provided within limit for listed transaction types and currencies:

    Transaction Type Currency minimum maximum
    Global limit All 0.01 1,000,000,000.00
    alipay All 10.00 3,000.00
    zimpler EUR 3.50 1,500.00
    SEK 35.00 15,000.00
    qiwi EUR 5.00 350.00
    USD 5.00 500.00
    RUB 500.00 15,000.00
    KZT 500.00 74,300.00
    entercash EUR 0.01 5,000.00
    SEK 0.01 500,000.00
    davivienda USD 0.01 3,000.00
    banco de chile USD 0.01 3,000.00
    webpay USD 0.01 3,000.00
    pago facil USD 0.01 3,000.00
    rapi pago USD 0.01 3,000.00
    link USD 0.01 3,000.00
    santander cash USD 0.01 3,000.00
    santander USD 0.01 3,000.00
    aura USD 0.01 3,000.00
    cabal USD 0.01 3,000.00
    nativa USD 0.01 3,000.00
    naranja USD 0.01 3,000.00
    cencosud USD 0.01 3,000.00
    tarjeta shopping USD 0.01 3,000.00
    redpagos USD 0.01 3,000.00
    bcmc EUR 1,00 1,000,000.00
    elo USD 0.01 3,000.00
    oxxo USD 0.01 3,000.00
    bradesco USD 0.01 3,000.00
    cartao mercado livre USD 0.01 3,000.00
    efecty USD 0.01 3,000.00
    boleto USD 2.50 2,500.00
    itau USD 0.01 3,000.00
    multibanco USD 0.01 99,999.99
    banco do brasil USD 0.01 3,000.00
    argencard USD 0.01 3,000.00
    banco de occidente USD 0.01 3,000.00
    bancomer USD 0.01 3,000.00
    banamex USD 0.01 3,000.00
    giropay EUR 1.00 1,000,000,000.00
    baloto USD 0.01 3,000.00
    eps EUR 1.00 1,000,000.00
    sofort EUR 1.00 5,000.00
    sdd sale All 0.10 24,999.99
    sct payout All 0.10 24,999.99
    sdd init recurring sale All 0.10 24,999.99
    sdd refund All 0.10 24,999.99
    neosurf All 0.01 9,999.99
    p24 EUR 0.01 15,000.00
    rpn payment All 0.10 100,000.00
    rpn payout All 100.00 1,000,000.00
    citadel payin EUR 0.01 10,000.00
    citadel payout EUR 0.01 10,000.00
    idebit payin CAD 0.01 1,500.00
    idebit payout CAD 0.01 1,500.00
    online banking CNY* 10.00 50,000.00
    THB 10.00 500,000.00
    IDR 10,000.00 50,000,000.00
    MYR 10.00 20,000.00
    bank payout CNY 60.00 49,000.00
    THB 350.00 175,000.00
    IDR 50,000.00 25,000,000.00
    MYR 50.00 20,000.00
    wechat All 10.00 3,000.00
    ezeecard payout EUR 10.00 800.00
    paysafecard EUR 0.01 1,000.00
    poli AUD 0.01 9,999.00
    insta debit payin CAD 0.01 1,500.00
    bitpay USD 1.00 950,000.00
    bitpay sale USD 1.00 950,000.00
    bitpay payout USD 1.00 950,000.00
    pse USD 0.01 3,000.00

    * = Depends on the setup

    Check the ISO 4217 standard for details on currencies and their exponents/minor currency units.

    Dynamic Descriptor

    Dynamic descriptor functionality is available as part of the gateway. It is enabled on terminal level, so contact the IT Support team at tech-support@e-comprocessing.com if you wish to use it.

    Currently, the transactions types that support dynamic descriptor parameters are Authorize, Authorize3d, Sale, Sale3d, InitRecurringSale, InitRecurringSale3d, Payout, and PaybyvoucherSale.

    WPF payments also support dynamic descriptor.

    The currently supported dynamic descriptor parameters are:

    Name Type Description
    merchant_name string(25) Needed by merchants/PSPs to change the charge description. Any chars above 25 are truncated. If the merchant name is less than 25 chars, it is right padded with whitespace before sent to the schemes
    merchant_city string(13) Contains the city of the merchant for card-present merchants and the merchant phone number for CNP merchants. Formatting rules applied as mentioned above

    If the terminal is configured with dynamic descriptor, but the merchant does not send the dynamic desccriptor parameter in question at all or sends whitespace, this defaults the given dynamic descriptor parameter to the static descriptor configured on MID level when submitted to the schemes.

    Note also that the dynamic descriptor params section with the properly formatted individual dynamic descriptor params is returned in the payment transaction response on the API if those params have been submitted in the transaction API request beforehand.

    Regarding reference-based transactions, since they do not accept any dynamic descriptor params in the request, there is no dynamic descrptor params section in the response as well. Reference-based transactions reuse the dynamic descriptor params of their original transaction.

    Electronic Commerce Indicator

    Electronic Commerce Indicator (ECI) is a value that is returned from the Directory Server (Visa, MasterCard, etc.) to indicate the authentication results of your customer’s credit card payment on 3D Secure.

    Visa/JCB/Diners/American Express/Rupay

    ECI Code Description
    05 Both cardholder and card issuing bank are 3D enabled. 3D card authentication is successful
    06 Either cardholder or card issuing bank is not 3D enrolled. 3D card authentication is unsuccessful, in sample situations as: 1. 3D cardholder not enrolled 2. Card issuing bank is not 3D Secure ready
    07 Authentication is unsuccessful or not attempted. The credit card is either a non-3D card or card issuing bank does not handle it as a 3D transaction

    MasterCard/Maestro

    ECI Code Description
    02 Both cardholder and card issuing bank are 3D enabled. 3D card authentication is successful
    01 Either cardholder or card issuing bank is not 3D enrolled. 3D card authentication is unsuccessful, in sample situations as: 1. 3D Cardholder not enrolled 2. Card issuing bank is not 3D Secure ready
    00 (or empty) Authentication is unsuccessful or not attempted. The credit card is either a non-3D card or card issuing bank does not handle it as a 3D transaction

    Issuer Response Codes

    See below a list of issuer response codes with the corresponding messages. Issuer response codes (response code element) are di↵erent than the regular gateway codes (code element) - the issuer response code maps to the issuer code while the code is the gateway internal code mapping and part of the API, as described in the Errors section. Transaction responses will return the relevant issuer response code (note that both issuer response code and authorization code are optional in the API responses and will be returned only if the transaction reached the issuer)

    Issuer Response Code Issuer Message
    00 Approved or completed successfully
    02 Refer to card issuer
    03 Invalid merchant
    04 Pickup card
    05 Do not honour
    06 Invalid Transaction for Terminal
    07 Honour with ID
    08 Time-Out
    09 No Original
    10 Unable to Reverse
    11 Partial Approval
    12 Invalid transaction card / issuer / acquirer
    13 Invalid amount
    14 Invalid card number
    17 Invalid Capture date, terminal business date
    19 System Error, Re-enter transaction
    20 No From Account
    21 No To Account
    22 No Checking Account
    23 No Saving Account
    24 No Credit Account
    30 Format error
    34 Implausible card data
    39 Transaction Not Allowed
    41 Pick-up card
    42 Special Pickup
    43 Hot Card, Pickup if possible
    44 Pickup Card
    45 Transaction Back O↵
    51 Not su cient funds
    54 Expired card
    55 Incorrect PIN, Re-enter
    57 Not permitted on card
    58 Txn Not Permitted On Term
    61 Exceeds amount limit
    62 Restricted card
    63 MAC Key Error
    65 Exceeds frequency limit
    66 Exceeds Acquirer Limit
    67 Retain Card, no reason specified
    68 Response received too late
    75 Exceeds PIN Retry
    76 Invalid Account
    77 Issuer Does Not Participate In The Service
    78 Function Not Available
    79 Key Validation Error
    80 Approval for Purchase Amount Only
    81 Unable to Verify PIN
    82 Invalid Card Verification Value
    83 Not declined, AVS Only
    84 Invalid Life Cycle of transaction
    85 No Keys To Use
    86 K M E Sync Error
    87 PIN Key Error
    88 MAC sync Error
    89 Security Violation
    91 Issuer not available
    92 Invalid Issuer
    93 Transaction cannot be completed
    94 Invalid originator
    96 System malfunction
    97 No Funds Transfer
    98 Duplicate Reversal
    99 Duplicate Transaction
    N3 Cash Service Not Available
    N4 Cash Back Request Exceeds Issuer Limit
    N7 CVV2 Failure
    R0 Stop Payment Order
    R1 Revocation of Authorisation Order
    R3 Revocation of all Authorisations Order

    Manually Reviewed Transactions

    Under certain conditions, transactions can be stopped for manual review by the Risk team. This happens when the appropriate risk rules have been enabled for the merchant in question. Feel free to discuss enabling of manual reviews for transactions with our Risk team. Transactions that are stopped for manual review are returned with status ’pending review’ in the API response, together with a detailed message specifying a manual review of this transaction. Note that transactions will be manually reviewed by the Risk team in the next 24 hours. In the process, each transaction will be manually approved or manually declined, and at this point the merchant will receive a notification with the status of the transaction, see Notifications.

    Special case for manual reviewing is when the transaction is 3D async, in this case the merchant receives one notification if the transaction is manually declined by the Risk team, and two notifications if the transaction is manually approved. On manual approval, the first notification is sent once the transaction is manually approved and is sent for enrollment check to the MPI provider - the notification will contain status pending asyc together with the redirect url where the consumer needs to be redirected to by the merchant. The second notification is the standard 3D notification, once a consumer has been redirected to the given redirect url, has entered his/her MPI password, and contains the final status of the transaction whether it is approved by the issuer, or declined for invalid 3D password, and so on

    The format of the first notification for manual review and following approval is:

    ?transaction_id=82803B4C-70CC-43BD-8B21-FD0395285B40
&unique_id=44177a21403427eb96664a6d7e5d5d48
&transaction_type=sale3d
&terminal_token=394f2ebc3646d3c017fa1e1cbc4a1e20
&status=pending_async
&amount=500
&signature=088e16a1019277b15d58faf0541e11910eb756f6
&eci=06
&redirect_url=http://example.com/redirect_url

    The second notification is the same as the typical 3D notifications for final statuses after the consumer has performed the 3D workflow.

    Partial Approvals

    Credit cards that do not have sufficient funds in their account for the full purchase amount may be provided with a partial approval response from the issuer. When a partial approval happens, there will be a flag confirming the partial approval in the response (partial approval set to ’true’) and the amount field in the response will contain the actual partially approved amount instead of the requested one in the API request. The cardholder can then choose to use a supplemental payment method to pay the balance and complete the purchase, if so desired. Merchants that accept partial approvals should note that issuers may return a partial approval response on a pre-paid/debit card at any time, and issuers may also respond with a partial approval response amount that is equal to the requested amount.

    Have in mind that full/partial refunds or captures need to reference the partially approved initial transaction, you will get a workflow error if trying to capture or refund more than the partially approved amount. So make sure you check for the partial approval flag in the API response for the relevant transaction types, and handle follow-up transaction amounts properly.

    With 3-D secure transactions, if a partial approval happened, the partially approved amount will be returned in the async API notification to the merchant. This is because actual communication with the acquirers happen after 3D authentication by the cardholder, in the initial API response the merchant will get the requested amount with the status ’pending async’ for the transaction.

    Note that partial approval support is disabled by default, feel free to contact our Risk team to enable it.

    Preauthorizations

    Preauthorizations are used to request Approval for an estimated transaction amount because the final transaction amount will only be known some time later. This type of message is typically sent for transactions such as car rentals, hotel rooms and petrol. The reason for the preauthorization is to authenticate the card and the cardholder and also to check funds availability.

    They are similar to the final authorizations, but have longer authorize time-frame and allow amount to be extended (restricted per card brand).

    Basic Workflow

    Preauthorization

    Preauthorization transaction can be submitted via normal Authorize or Authorize3d transaction with additional request param preauthorization.

    To enable this, please contact tech-support@e-comprocessing.com.

    Supported Card brands

    Visa

    Visa Lodging Preauthorization Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Authorize');
$request = $genesis->request();

$request
  ->setTransactionId('TrxID_4d29d38bc213c9204df6cec6debee6dc')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('5000')
  ->setCurrency('USD')
  ->setPreauthorization('true')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.AuthorizeRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    AuthorizeRequest request = new AuthorizeRequest();

    request.setTransactionId("TrxID_4d29d38bc213c9204df6cec6debee6dc");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(5000));
    request.setCurrency("USD");
    request.setPreauthorization("true");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.authorize(
  {
    "transaction_id": "TrxID_4d29d38bc213c9204df6cec6debee6dc",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": 5000,
    "currency": "USD",
    "preauthorization": true,
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <transaction_id>TrxID_4d29d38bc213c9204df6cec6debee6dc</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>5000</amount>
    <currency>USD</currency>
    <preauthorization>true</preauthorization>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Successful Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [mode] => live
    [transaction_id] => TrxID_4d29d38bc213c9204df6cec6debee6dc
    [unique_id] => 608d13a3723f658e8b35a32bb6e10c29
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 564162
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:09.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 5000
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[TrxID_4d29d38bc213c9204df6cec6debee6dc]>
    <unique_id content=[608d13a3723f658e8b35a32bb6e10c29]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[564162]>
    <response_code content=[00]>
    <timestamp content=[2019-09-17T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5000]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    mode: "live",
    transaction_id: "TrxID_4d29d38bc213c9204df6cec6debee6dc",
    unique_id: "608d13a3723f658e8b35a32bb6e10c29",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "564162",
    response_code: "00",
    timestamp: "2019-09-17T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "5000",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>TrxID_4d29d38bc213c9204df6cec6debee6dc</transaction_id>
    <unique_id>608d13a3723f658e8b35a32bb6e10c29</unique_id>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>564162</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5000</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Reconcile Visa Preauthorization Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\Reconcile\Transaction');
$request = $genesis->request();

$request
  ->setUniqueId('608d13a3723f658e8b35a32bb6e10c29');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.reconcile.ReconcileRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    ReconcileRequest request = new ReconcileRequest();

    request.setUniqueId("608d13a3723f658e8b35a32bb6e10c29");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.reconcile(
  {
    "unique_id": "608d13a3723f658e8b35a32bb6e10c29"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/reconcile/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <reconcile>
    <unique_id>608d13a3723f658e8b35a32bb6e10c29</unique_id>
  </reconcile>'

    Successful Preauthorization Reconciliation Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [authorization_code] => 564162
    [response_code] => 00
    [unique_id] => 608d13a3723f658e8b35a32bb6e10c29
    [transaction_id] => TrxID_4d29d38bc213c9204df6cec6debee6dc
    [mode] => live
    [timestamp] => 2019-09-17T15:39:09Z
    [descriptor] => Descriptor one
    [amount] => 5000
    [currency] => USD
    [card_brand] => visa
    [card_number] => 420000...0000
    [sent_to_acquirer] => true
    [preauthorization] => true
    [preauthorization_expires_at] => 2019-10-18T15:39:09Z
    [preauthorization_total_amount] => 5000
    [capturable_amount] => 5750
    [captured_amount] => 0
    [reversed_amount] => 0
    [reversible_amount] => 5000
    [arn] => 74537605259536043849425
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <authorization_code content=[564162]>
    <response_code content=[00]>
    <unique_id content=[608d13a3723f658e8b35a32bb6e10c29]>
    <transaction_id content=[TrxID_4d29d38bc213c9204df6cec6debee6dc]>
    <mode content=[live]>
    <timestamp content=[2019-09-17T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5000]>
    <currency content=[USD]>
    <card_brand content=[visa]>
    <card_number content=[420000...0000]>
    <sent_to_acquirer content=[true]>
    <preauthorization content=[true]>
    <preauthorization_expires_at content=[2019-10-18T15:39:09Z]>
    <preauthorization_total_amount content=[5000]>
    <capturable_amount content=[5750]>
    <captured_amount content=[0]>
    <reversed_amount content=[0]>
    <reversible_amount content=[5000]>
    <arn content=[74537605259536043849425]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    authorization_code: "564162",
    response_code: "00",
    unique_id: "608d13a3723f658e8b35a32bb6e10c29",
    transaction_id: "TrxID_4d29d38bc213c9204df6cec6debee6dc",
    mode: "live",
    timestamp: "2019-09-17T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "5000",
    currency: "USD",
    card_brand: "visa",
    card_number: "420000...0000",
    sent_to_acquirer: "true",
    preauthorization: "true",
    preauthorization_expires_at: "2019-10-18T15:39:09Z",
    preauthorization_total_amount: "5000",
    capturable_amount: "5750",
    captured_amount: "0",
    reversed_amount: "0",
    reversible_amount: "5000",
    arn: "74537605259536043849425",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_response>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <authorization_code>564162</authorization_code>
    <response_code>00</response_code>
    <unique_id>608d13a3723f658e8b35a32bb6e10c29</unique_id>
    <transaction_id>TrxID_4d29d38bc213c9204df6cec6debee6dc</transaction_id>
    <mode>live</mode>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5000</amount>
    <currency>USD</currency>
    <card_brand>visa</card_brand>
    <card_number>420000...0000</card_number>
    <sent_to_acquirer>true</sent_to_acquirer>
    <preauthorization>true</preauthorization>
    <preauthorization_expires_at>2019-10-18T15:39:09Z</preauthorization_expires_at>
    <preauthorization_total_amount>5000</preauthorization_total_amount>
    <capturable_amount>5750</capturable_amount>
    <captured_amount>0</captured_amount>
    <reversed_amount>0</reversed_amount>
    <reversible_amount>5000</reversible_amount>
    <arn>74537605259536043849425</arn>
  </payment_response>
    MCC Segment Authorization timeframe Amount tolerance
    3501-3999, 7011 Lodging 31 days 15%
    3351-3500, 7512 Car Rental 31 days 15%
    4411 Steamship and Cruise Lines 31 days 15%
    7513 Truck Rentals 7 days 15%
    7033 Trailer Parks and Campgrounds 7 days 15%
    7519 Motor Home and Recreational Vehicle Rentals 7 days 15%
    5411 Grocery 7 days 15%
    5552 Electric Vehicle Charging 7 days 15%
    7523 Parking and Garages 7 days 15%
    7394 Equipment, Tool, Furniture and Appliance Rental 7 days none
    7999 Recreation Services 7 days none
    7996 Amusement Parks, Carnivals, Circuses, Fortune Tellers 7 days none
    4111 Local and Suburban Commuter, Passenger Transportation, including Ferries 7 days1 25 USD3
    4112 Passenger Railways 7 days1 25 USD3
    4131 Bus Lines 7 days1 25 USD3
    5812 Eating Places and Restaurants end of approval day2 20%
    5813 Drinking Places, Bars, Taverns, Cocktail Lounges, Nightclubs, Discotheques end of approval day2 20%
    4121 Taxicabs and Limousines (Card-Absent Environment only) end of approval day2 20%

    7 days1 - 7 days (3 days for US merchant region)

    end of approval day2 - end of approval day (in the acquirer's timezone)

    25 USD3 - a capture with amount up to 25 USD can be requested without a need of additional incremental authorization. Just in case the authorized amount is less than 25 USD (15 USD for merchants in the US region). The respective amount will be exchanged to the transaction currency in case the currency is different than USD.

    Mastercard

    Master Lodging Preauthorization Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Authorize');
$request = $genesis->request();

$request
  ->setTransactionId('TrxID_81540503734a144a1eb0a6b3a6e5f492')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('5000')
  ->setCurrency('USD')
  ->setPreauthorization('true')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('5555555555554444')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.AuthorizeRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    AuthorizeRequest request = new AuthorizeRequest();

    request.setTransactionId("TrxID_81540503734a144a1eb0a6b3a6e5f492");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(5000));
    request.setCurrency("USD");
    request.setPreauthorization("true");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("5555555555554444");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.authorize(
  {
    "transaction_id": "TrxID_81540503734a144a1eb0a6b3a6e5f492",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": 5000,
    "currency": "USD",
    "preauthorization": true,
    "card_holder": "Travis Pastrana",
    "card_number": "5555555555554444",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <transaction_id>TrxID_81540503734a144a1eb0a6b3a6e5f492</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>5000</amount>
    <currency>USD</currency>
    <preauthorization>true</preauthorization>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>5555555555554444</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Successful Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [mode] => live
    [transaction_id] => TrxID_81540503734a144a1eb0a6b3a6e5f492
    [unique_id] => 17af6b2a9c0eecff061e6eecf9214d53
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 462846
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-16 15:39:09.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 5000
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[TrxID_81540503734a144a1eb0a6b3a6e5f492]>
    <unique_id content=[17af6b2a9c0eecff061e6eecf9214d53]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[462846]>
    <response_code content=[00]>
    <timestamp content=[2019-09-16T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5000]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    mode: "live",
    transaction_id: "TrxID_81540503734a144a1eb0a6b3a6e5f492",
    unique_id: "17af6b2a9c0eecff061e6eecf9214d53",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "462846",
    response_code: "00",
    timestamp: "2019-09-16T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "5000",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>TrxID_81540503734a144a1eb0a6b3a6e5f492</transaction_id>
    <unique_id>17af6b2a9c0eecff061e6eecf9214d53</unique_id>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>462846</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-16T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5000</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Reconcile Master Preauthorization Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\Reconcile\Transaction');
$request = $genesis->request();

$request
  ->setUniqueId('17af6b2a9c0eecff061e6eecf9214d53');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.reconcile.ReconcileRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    ReconcileRequest request = new ReconcileRequest();

    request.setUniqueId("17af6b2a9c0eecff061e6eecf9214d53");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.reconcile(
  {
    "unique_id": "17af6b2a9c0eecff061e6eecf9214d53"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/reconcile/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <reconcile>
    <unique_id>17af6b2a9c0eecff061e6eecf9214d53</unique_id>
  </reconcile>'

    Successful Preauthorization Reconciliation Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [authorization_code] => 462846
    [response_code] => 00
    [unique_id] => 17af6b2a9c0eecff061e6eecf9214d53
    [transaction_id] => TrxID_81540503734a144a1eb0a6b3a6e5f492
    [mode] => live
    [timestamp] => 2019-09-16T15:39:09Z
    [descriptor] => Descriptor one
    [amount] => 5000
    [currency] => USD
    [card_brand] => master
    [card_number] => 555555...4444
    [sent_to_acquirer] => true
    [preauthorization] => true
    [preauthorization_expires_at] => 2019-10-16T15:39:09Z
    [preauthorization_total_amount] => 5000
    [capturable_amount] => 5000
    [captured_amount] => 0
    [reversed_amount] => 0
    [reversible_amount] => 5000
    [arn] => 74537605259536043849425
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <authorization_code content=[462846]>
    <response_code content=[00]>
    <unique_id content=[17af6b2a9c0eecff061e6eecf9214d53]>
    <transaction_id content=[TrxID_81540503734a144a1eb0a6b3a6e5f492]>
    <mode content=[live]>
    <timestamp content=[2019-09-16T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5000]>
    <currency content=[USD]>
    <card_brand content=[master]>
    <card_number content=[555555...4444]>
    <sent_to_acquirer content=[true]>
    <preauthorization content=[true]>
    <preauthorization_expires_at content=[2019-10-16T15:39:09Z]>
    <preauthorization_total_amount content=[5000]>
    <capturable_amount content=[5000]>
    <captured_amount content=[0]>
    <reversed_amount content=[0]>
    <reversible_amount content=[5000]>
    <arn content=[74537605259536043849425]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    authorization_code: "462846",
    response_code: "00",
    unique_id: "17af6b2a9c0eecff061e6eecf9214d53",
    transaction_id: "TrxID_81540503734a144a1eb0a6b3a6e5f492",
    mode: "live",
    timestamp: "2019-09-16T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "5000",
    currency: "USD",
    card_brand: "master",
    card_number: "555555...4444",
    sent_to_acquirer: "true",
    preauthorization: "true",
    preauthorization_expires_at: "2019-10-16T15:39:09Z",
    preauthorization_total_amount: "5000",
    capturable_amount: "5000",
    captured_amount: "0",
    reversed_amount: "0",
    reversible_amount: "5000",
    arn: "74537605259536043849425",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_response>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <authorization_code>462846</authorization_code>
    <response_code>00</response_code>
    <unique_id>17af6b2a9c0eecff061e6eecf9214d53</unique_id>
    <transaction_id>TrxID_81540503734a144a1eb0a6b3a6e5f492</transaction_id>
    <mode>live</mode>
    <timestamp>2019-09-16T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5000</amount>
    <currency>USD</currency>
    <card_brand>master</card_brand>
    <card_number>555555...4444</card_number>
    <sent_to_acquirer>true</sent_to_acquirer>
    <preauthorization>true</preauthorization>
    <preauthorization_expires_at>2019-10-16T15:39:09Z</preauthorization_expires_at>
    <preauthorization_total_amount>5000</preauthorization_total_amount>
    <capturable_amount>5000</capturable_amount>
    <captured_amount>0</captured_amount>
    <reversed_amount>0</reversed_amount>
    <reversible_amount>5000</reversible_amount>
    <arn>74537605259536043849425</arn>
  </payment_response>

    Maestro

    Intl Maestro Lodging Preauthorization Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Authorize');
$request = $genesis->request();

$request
  ->setTransactionId('TrxID_23352af5f2b687ee38959d2e35d1faee')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('5000')
  ->setCurrency('USD')
  ->setPreauthorization('true')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('6759411100000008')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.AuthorizeRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    AuthorizeRequest request = new AuthorizeRequest();

    request.setTransactionId("TrxID_23352af5f2b687ee38959d2e35d1faee");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(5000));
    request.setCurrency("USD");
    request.setPreauthorization("true");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("6759411100000008");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.authorize(
  {
    "transaction_id": "TrxID_23352af5f2b687ee38959d2e35d1faee",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": 5000,
    "currency": "USD",
    "preauthorization": true,
    "card_holder": "Travis Pastrana",
    "card_number": "6759411100000008",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <transaction_id>TrxID_23352af5f2b687ee38959d2e35d1faee</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>5000</amount>
    <currency>USD</currency>
    <preauthorization>true</preauthorization>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>6759411100000008</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>'

    Successful Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [mode] => live
    [transaction_id] => TrxID_23352af5f2b687ee38959d2e35d1faee
    [unique_id] => b5826d5aa162a0b701d214404feec6c3
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 327405
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-15 15:39:09.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 5000
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[TrxID_23352af5f2b687ee38959d2e35d1faee]>
    <unique_id content=[b5826d5aa162a0b701d214404feec6c3]>
    <avs_response_code content=[5I]>
    <avs_response_text content=[Response provided by issuer processor; Address information not verified]>
    <authorization_code content=[327405]>
    <response_code content=[00]>
    <timestamp content=[2019-09-15T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5000]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    mode: "live",
    transaction_id: "TrxID_23352af5f2b687ee38959d2e35d1faee",
    unique_id: "b5826d5aa162a0b701d214404feec6c3",
    avs_response_code: "5I",
    avs_response_text: "Response provided by issuer processor; Address information not verified",
    authorization_code: "327405",
    response_code: "00",
    timestamp: "2019-09-15T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "5000",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>TrxID_23352af5f2b687ee38959d2e35d1faee</transaction_id>
    <unique_id>b5826d5aa162a0b701d214404feec6c3</unique_id>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>327405</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-15T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5000</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Reconcile Intl Maestro Preauthorization Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\Reconcile\Transaction');
$request = $genesis->request();

$request
  ->setUniqueId('b5826d5aa162a0b701d214404feec6c3');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.reconcile.ReconcileRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    ReconcileRequest request = new ReconcileRequest();

    request.setUniqueId("b5826d5aa162a0b701d214404feec6c3");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.reconcile(
  {
    "unique_id": "b5826d5aa162a0b701d214404feec6c3"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/reconcile/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <reconcile>
    <unique_id>b5826d5aa162a0b701d214404feec6c3</unique_id>
  </reconcile>'

    Successful Preauthorization Reconciliation Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [authorization_code] => 327405
    [response_code] => 00
    [unique_id] => b5826d5aa162a0b701d214404feec6c3
    [transaction_id] => TrxID_23352af5f2b687ee38959d2e35d1faee
    [mode] => live
    [timestamp] => 2019-09-15T15:39:09Z
    [descriptor] => Descriptor one
    [amount] => 5000
    [currency] => USD
    [card_brand] => Intl Maestro
    [card_number] => 675941...0008
    [sent_to_acquirer] => true
    [preauthorization] => true
    [preauthorization_expires_at] => 2019-09-22T15:39:09Z
    [preauthorization_total_amount] => 5000
    [capturable_amount] => 5000
    [captured_amount] => 0
    [reversed_amount] => 0
    [reversible_amount] => 5000
    [arn] => 74537605259536043849425
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <authorization_code content=[327405]>
    <response_code content=[00]>
    <unique_id content=[b5826d5aa162a0b701d214404feec6c3]>
    <transaction_id content=[TrxID_23352af5f2b687ee38959d2e35d1faee]>
    <mode content=[live]>
    <timestamp content=[2019-09-15T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5000]>
    <currency content=[USD]>
    <card_brand content=[Intl Maestro]>
    <card_number content=[675941...0008]>
    <sent_to_acquirer content=[true]>
    <preauthorization content=[true]>
    <preauthorization_expires_at content=[2019-09-22T15:39:09Z]>
    <preauthorization_total_amount content=[5000]>
    <capturable_amount content=[5000]>
    <captured_amount content=[0]>
    <reversed_amount content=[0]>
    <reversible_amount content=[5000]>
    <arn content=[74537605259536043849425]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    authorization_code: "327405",
    response_code: "00",
    unique_id: "b5826d5aa162a0b701d214404feec6c3",
    transaction_id: "TrxID_23352af5f2b687ee38959d2e35d1faee",
    mode: "live",
    timestamp: "2019-09-15T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "5000",
    currency: "USD",
    card_brand: "Intl Maestro",
    card_number: "675941...0008",
    sent_to_acquirer: "true",
    preauthorization: "true",
    preauthorization_expires_at: "2019-09-22T15:39:09Z",
    preauthorization_total_amount: "5000",
    capturable_amount: "5000",
    captured_amount: "0",
    reversed_amount: "0",
    reversible_amount: "5000",
    arn: "74537605259536043849425",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_response>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <authorization_code>327405</authorization_code>
    <response_code>00</response_code>
    <unique_id>b5826d5aa162a0b701d214404feec6c3</unique_id>
    <transaction_id>TrxID_23352af5f2b687ee38959d2e35d1faee</transaction_id>
    <mode>live</mode>
    <timestamp>2019-09-15T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5000</amount>
    <currency>USD</currency>
    <card_brand>Intl Maestro</card_brand>
    <card_number>675941...0008</card_number>
    <sent_to_acquirer>true</sent_to_acquirer>
    <preauthorization>true</preauthorization>
    <preauthorization_expires_at>2019-09-22T15:39:09Z</preauthorization_expires_at>
    <preauthorization_total_amount>5000</preauthorization_total_amount>
    <capturable_amount>5000</capturable_amount>
    <captured_amount>0</captured_amount>
    <reversed_amount>0</reversed_amount>
    <reversible_amount>5000</reversible_amount>
    <arn>74537605259536043849425</arn>
  </payment_response>

    Reconcile the preauthorization to retrieve the Preauthorization specifics:

    Incremental Authorize

    Incremental authorizations are used in preauthorization workflow to:

    An incremental authorization transaction can be submitted in case:

    Extend Preauthorization Timeframe & Amount

    Mastercard Incremental Authorization Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Preauthorization\IncrementalAuthorize');
$request = $genesis->request();

$request
  ->setTransactionId('TrxID_4002009d61d5944d3e2956b5f4d07efd')
  ->setUsage('20469237 extend hotel rezervation')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('1000')
  ->setReferenceId('17af6b2a9c0eecff061e6eecf9214d53');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>incremental_authorize</transaction_type>
    <transaction_id>TrxID_4002009d61d5944d3e2956b5f4d07efd</transaction_id>
    <usage>20469237 extend hotel rezervation</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>1000</amount>
    <reference_id>17af6b2a9c0eecff061e6eecf9214d53</reference_id>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: incremental_authorize
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required* string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer >= 0 Topup amount in minor currency unit, see Currency and Amount Handling for details
    reference_id required string(32) Unique id of the corresponding preauthorization transaction

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => incremental_authorize
    [status] => approved
    [mode] => live
    [transaction_id] => TrxID_4002009d61d5944d3e2956b5f4d07efd
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [avs_response_code] => 5I
    [avs_response_text] => Response provided by issuer processor; Address information not verified
    [authorization_code] => 485335
    [response_code] => 00
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:09.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 1000
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>incremental_authorize</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>TrxID_4002009d61d5944d3e2956b5f4d07efd</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <avs_response_code>5I</avs_response_code>
    <avs_response_text>Response provided by issuer processor; Address information not verified</avs_response_text>
    <authorization_code>485335</authorization_code>
    <response_code>00</response_code>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>1000</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    partial_approval string(4) Optional, set to ’true’ if partial approval happened. Partially approved amount is then in the amount field. Check Partial Approvals for details
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => incremental_authorize
    [status] => error
    [mode] => live
    [transaction_id] => TrxID_4002009d61d5944d3e2956b5f4d07efd
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 400
    [technical_message] => Preauthorization has been captured, no further incremental authorizations allowed
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:09.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 1000
    [currency] => USD
    [sent_to_acquirer] => false
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>incremental_authorize</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>TrxID_4002009d61d5944d3e2956b5f4d07efd</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>400</code>
    <technical_message>Preauthorization has been captured, no further incremental authorizations allowed</technical_message>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>1000</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    dynamic_descriptor_params section Optional, returned only if dynamic desc params are submitted on the API. Note here that the formatted dyn desc params are returned - as they would be submitted to the schemes for settlement.

    Example Xml For Extending The Time Frame Only

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Preauthorization\IncrementalAuthorize');
$request = $genesis->request();

$request
  ->setTransactionId('TrxID_4002009d61d5944d3e2956b5f4d07efd')
  ->setUsage('204692378 extend the preauthorization validity timeframe')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('0')
  ->setReferenceId('608d13a3723f658e8b35a32bb6e10c29');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>incremental_authorize</transaction_type>
    <transaction_id>TrxID_4002009d61d5944d3e2956b5f4d07efd</transaction_id>
    <usage>204692378 extend the preauthorization validity timeframe</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>0</amount>
    <reference_id>608d13a3723f658e8b35a32bb6e10c29</reference_id>
  </payment_transaction>'

    Error Response

    stdClass Object
(
    [transaction_type] => incremental_authorize
    [status] => error
    [mode] => live
    [transaction_id] => TrxID_4002009d61d5944d3e2956b5f4d07efd
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 400
    [technical_message] => Incremental authorizations with no financial impact are currently not supported by card brand
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:09.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 0
    [currency] => USD
    [sent_to_acquirer] => false
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>incremental_authorize</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>TrxID_4002009d61d5944d3e2956b5f4d07efd</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>400</code>
    <technical_message>Incremental authorizations with no financial impact are currently not supported by card brand</technical_message>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>0</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Reconcile Preauthorization By Unique Id Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\Reconcile\Transaction');
$request = $genesis->request();

$request
  ->setUniqueId('17af6b2a9c0eecff061e6eecf9214d53');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.reconcile.ReconcileRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    ReconcileRequest request = new ReconcileRequest();

    request.setUniqueId("17af6b2a9c0eecff061e6eecf9214d53");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.reconcile(
  {
    "unique_id": "17af6b2a9c0eecff061e6eecf9214d53"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/reconcile/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <reconcile>
    <unique_id>17af6b2a9c0eecff061e6eecf9214d53</unique_id>
  </reconcile>'

    Successful Preauthorization Reconciliation Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [authorization_code] => 485335
    [response_code] => 00
    [unique_id] => 17af6b2a9c0eecff061e6eecf9214d53
    [transaction_id] => TrxID_4002009d61d5944d3e2956b5f4d07efd
    [mode] => live
    [timestamp] => 2019-09-17T15:39:09Z
    [descriptor] => Descriptor one
    [amount] => 5000
    [currency] => USD
    [card_brand] => master
    [card_number] => 555555...4444
    [sent_to_acquirer] => true
    [preauthorization] => true
    [preauthorization_expires_at] => 2019-11-15T15:39:09Z
    [preauthorization_total_amount] => 6000
    [capturable_amount] => 6000
    [captured_amount] => 0
    [arn] => 74537605259536043849425
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <authorization_code content=[485335]>
    <response_code content=[00]>
    <unique_id content=[17af6b2a9c0eecff061e6eecf9214d53]>
    <transaction_id content=[TrxID_4002009d61d5944d3e2956b5f4d07efd]>
    <mode content=[live]>
    <timestamp content=[2019-09-17T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5000]>
    <currency content=[USD]>
    <card_brand content=[master]>
    <card_number content=[555555...4444]>
    <sent_to_acquirer content=[true]>
    <preauthorization content=[true]>
    <preauthorization_expires_at content=[2019-11-15T15:39:09Z]>
    <preauthorization_total_amount content=[6000]>
    <capturable_amount content=[6000]>
    <captured_amount content=[0]>
    <arn content=[74537605259536043849425]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    authorization_code: "485335",
    response_code: "00",
    unique_id: "17af6b2a9c0eecff061e6eecf9214d53",
    transaction_id: "TrxID_4002009d61d5944d3e2956b5f4d07efd",
    mode: "live",
    timestamp: "2019-09-17T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "5000",
    currency: "USD",
    card_brand: "master",
    card_number: "555555...4444",
    sent_to_acquirer: "true",
    preauthorization: "true",
    preauthorization_expires_at: "2019-11-15T15:39:09Z",
    preauthorization_total_amount: "6000",
    capturable_amount: "6000",
    captured_amount: "0",
    arn: "74537605259536043849425",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_response>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <authorization_code>485335</authorization_code>
    <response_code>00</response_code>
    <unique_id>17af6b2a9c0eecff061e6eecf9214d53</unique_id>
    <transaction_id>TrxID_4002009d61d5944d3e2956b5f4d07efd</transaction_id>
    <mode>live</mode>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5000</amount>
    <currency>USD</currency>
    <card_brand>master</card_brand>
    <card_number>555555...4444</card_number>
    <sent_to_acquirer>true</sent_to_acquirer>
    <preauthorization>true</preauthorization>
    <preauthorization_expires_at>2019-11-15T15:39:09Z</preauthorization_expires_at>
    <preauthorization_total_amount>6000</preauthorization_total_amount>
    <capturable_amount>6000</capturable_amount>
    <captured_amount>0</captured_amount>
    <arn>74537605259536043849425</arn>
  </payment_response>

    Capture

    Preauthorizations can be captured using the standard Capture transaction with the correct reference_id of the Preauthorization.

    An additional incremental authorization will be necessary when the requested capture amount is greater than:

    Reconcile Visa Preauthorization Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\Reconcile\Transaction');
$request = $genesis->request();

$request
  ->setUniqueId('608d13a3723f658e8b35a32bb6e10c29');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.reconcile.ReconcileRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    ReconcileRequest request = new ReconcileRequest();

    request.setUniqueId("608d13a3723f658e8b35a32bb6e10c29");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.reconcile(
  {
    "unique_id": "608d13a3723f658e8b35a32bb6e10c29"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/reconcile/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <reconcile>
    <unique_id>608d13a3723f658e8b35a32bb6e10c29</unique_id>
  </reconcile>'

    Successful Preauthorization Reconciliation Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [authorization_code] => 005645
    [response_code] => 00
    [unique_id] => 608d13a3723f658e8b35a32bb6e10c29
    [transaction_id] => 119643250547501c79d8295
    [mode] => live
    [timestamp] => 2019-09-17T15:39:09Z
    [descriptor] => Descriptor one
    [amount] => 3000
    [currency] => USD
    [card_brand] => visa
    [card_number] => 420000...0000
    [sent_to_acquirer] => true
    [preauthorization] => true
    [preauthorization_expires_at] => 2019-10-18T15:39:09Z
    [preauthorization_total_amount] => 5000
    [capturable_amount] => 5750
    [captured_amount] => 0
    [reversed_amount] => 0
    [reversible_amount] => 5000
    [arn] => 74537605259536043849425
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <authorization_code content=[005645]>
    <response_code content=[00]>
    <unique_id content=[608d13a3723f658e8b35a32bb6e10c29]>
    <transaction_id content=[119643250547501c79d8295]>
    <mode content=[live]>
    <timestamp content=[2019-09-17T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[3000]>
    <currency content=[USD]>
    <card_brand content=[visa]>
    <card_number content=[420000...0000]>
    <sent_to_acquirer content=[true]>
    <preauthorization content=[true]>
    <preauthorization_expires_at content=[2019-10-18T15:39:09Z]>
    <preauthorization_total_amount content=[5000]>
    <capturable_amount content=[5750]>
    <captured_amount content=[0]>
    <reversed_amount content=[0]>
    <reversible_amount content=[5000]>
    <arn content=[74537605259536043849425]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    authorization_code: "005645",
    response_code: "00",
    unique_id: "608d13a3723f658e8b35a32bb6e10c29",
    transaction_id: "119643250547501c79d8295",
    mode: "live",
    timestamp: "2019-09-17T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "3000",
    currency: "USD",
    card_brand: "visa",
    card_number: "420000...0000",
    sent_to_acquirer: "true",
    preauthorization: "true",
    preauthorization_expires_at: "2019-10-18T15:39:09Z",
    preauthorization_total_amount: "5000",
    capturable_amount: "5750",
    captured_amount: "0",
    reversed_amount: "0",
    reversible_amount: "5000",
    arn: "74537605259536043849425",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_response>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <authorization_code>005645</authorization_code>
    <response_code>00</response_code>
    <unique_id>608d13a3723f658e8b35a32bb6e10c29</unique_id>
    <transaction_id>119643250547501c79d8295</transaction_id>
    <mode>live</mode>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>3000</amount>
    <currency>USD</currency>
    <card_brand>visa</card_brand>
    <card_number>420000...0000</card_number>
    <sent_to_acquirer>true</sent_to_acquirer>
    <preauthorization>true</preauthorization>
    <preauthorization_expires_at>2019-10-18T15:39:09Z</preauthorization_expires_at>
    <preauthorization_total_amount>5000</preauthorization_total_amount>
    <capturable_amount>5750</capturable_amount>
    <captured_amount>0</captured_amount>
    <reversed_amount>0</reversed_amount>
    <reversible_amount>5000</reversible_amount>
    <arn>74537605259536043849425</arn>
  </payment_response>

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Capture');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('Check out from the Hotel')
  ->setRemoteIp('245.253.2.12')
  ->setReferenceId('43672')
  ->setAmount('5500')
  ->setCurrency('USD');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.CaptureRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    CaptureRequest request = new CaptureRequest();

    request.setTransactionId("43671");
    request.setUsage("Check out from the Hotel");
    request.setRemoteIp("245.253.2.12");
    request.setReferenceId("43672");
    request.setAmount(new BigDecimal(5500));
    request.setCurrency("USD");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.capture(
  {
    "transaction_id": "43671",
    "usage": "Check out from the Hotel",
    "remote_ip": "245.253.2.12",
    "reference_id": "43672",
    "amount": 5500,
    "currency": "USD"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>capture</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>Check out from the Hotel</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <reference_id>43672</reference_id>
    <amount>5500</amount>
    <currency>USD</currency>
  </payment_transaction>'

    Successful Response

    stdClass Object
(
    [transaction_type] => capture
    [status] => approved
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [authorization_code] => 345678
    [response_code] => 00
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:09.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 5500
    [currency] => USD
    [sent_to_acquirer] => true
)

    <payment_response content=[
    <transaction_type content=[capture]>
    <status content=[approved]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <authorization_code content=[345678]>
    <response_code content=[00]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <timestamp content=[2019-09-17T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5500]>
    <currency content=[USD]>
    <sent_to_acquirer content=[true]>
]>

    {
    transaction_type: "capture",
    status: "approved",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    authorization_code: "345678",
    response_code: "00",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    timestamp: "2019-09-17T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "5500",
    currency: "USD",
    sent_to_acquirer: "true",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>capture</transaction_type>
    <status>approved</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5500</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Error Response

    stdClass Object
(
    [transaction_type] => capture
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 420
    [technical_message] => partial reversal is required first for the rest amount
    [message] => Transaction declined.
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:09.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 4000
    [currency] => USD
    [sent_to_acquirer] => false
)

    <payment_response content=[
    <transaction_type content=[capture]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[420]>
    <technical_message content=[partial reversal is required first for the rest amount]>
    <message content=[Transaction declined.]>
    <timestamp content=[2019-09-17T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[4000]>
    <currency content=[USD]>
    <sent_to_acquirer content=[false]>
]>

    {
    transaction_type: "capture",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "420",
    technical_message: "partial reversal is required first for the rest amount",
    message: "Transaction declined.",
    timestamp: "2019-09-17T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "4000",
    currency: "USD",
    sent_to_acquirer: "false",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>capture</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>420</code>
    <technical_message>partial reversal is required first for the rest amount</technical_message>
    <message>Transaction declined.</message>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>4000</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Reconcile Visa Preauthorization Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\Reconcile\Transaction');
$request = $genesis->request();

$request
  ->setUniqueId('608d13a3723f658e8b35a32bb6e10c29');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.reconcile.ReconcileRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    ReconcileRequest request = new ReconcileRequest();

    request.setUniqueId("608d13a3723f658e8b35a32bb6e10c29");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.reconcile(
  {
    "unique_id": "608d13a3723f658e8b35a32bb6e10c29"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/reconcile/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <reconcile>
    <unique_id>608d13a3723f658e8b35a32bb6e10c29</unique_id>
  </reconcile>'

    Successful Preauthorization Reconciliation Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [authorization_code] => 005645
    [response_code] => 00
    [unique_id] => 608d13a3723f658e8b35a32bb6e10c29
    [transaction_id] => 119643250547501c79d8295
    [mode] => live
    [timestamp] => 2019-09-17T15:39:09Z
    [descriptor] => Descriptor one
    [amount] => 3000
    [currency] => USD
    [card_brand] => visa
    [card_number] => 420000...0000
    [sent_to_acquirer] => true
    [preauthorization] => true
    [preauthorization_expires_at] => 2019-10-18T15:39:09Z
    [preauthorization_total_amount] => 5000
    [capturable_amount] => 0
    [captured_amount] => 5500
    [reversed_amount] => 0
    [reversible_amount] => 0
    [arn] => 74537605259536043849425
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <authorization_code content=[005645]>
    <response_code content=[00]>
    <unique_id content=[608d13a3723f658e8b35a32bb6e10c29]>
    <transaction_id content=[119643250547501c79d8295]>
    <mode content=[live]>
    <timestamp content=[2019-09-17T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[3000]>
    <currency content=[USD]>
    <card_brand content=[visa]>
    <card_number content=[420000...0000]>
    <sent_to_acquirer content=[true]>
    <preauthorization content=[true]>
    <preauthorization_expires_at content=[2019-10-18T15:39:09Z]>
    <preauthorization_total_amount content=[5000]>
    <capturable_amount content=[0]>
    <captured_amount content=[5500]>
    <reversed_amount content=[0]>
    <reversible_amount content=[0]>
    <arn content=[74537605259536043849425]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    authorization_code: "005645",
    response_code: "00",
    unique_id: "608d13a3723f658e8b35a32bb6e10c29",
    transaction_id: "119643250547501c79d8295",
    mode: "live",
    timestamp: "2019-09-17T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "3000",
    currency: "USD",
    card_brand: "visa",
    card_number: "420000...0000",
    sent_to_acquirer: "true",
    preauthorization: "true",
    preauthorization_expires_at: "2019-10-18T15:39:09Z",
    preauthorization_total_amount: "5000",
    capturable_amount: "0",
    captured_amount: "5500",
    reversed_amount: "0",
    reversible_amount: "0",
    arn: "74537605259536043849425",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_response>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <authorization_code>005645</authorization_code>
    <response_code>00</response_code>
    <unique_id>608d13a3723f658e8b35a32bb6e10c29</unique_id>
    <transaction_id>119643250547501c79d8295</transaction_id>
    <mode>live</mode>
    <timestamp>2019-09-17T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>3000</amount>
    <currency>USD</currency>
    <card_brand>visa</card_brand>
    <card_number>420000...0000</card_number>
    <sent_to_acquirer>true</sent_to_acquirer>
    <preauthorization>true</preauthorization>
    <preauthorization_expires_at>2019-10-18T15:39:09Z</preauthorization_expires_at>
    <preauthorization_total_amount>5000</preauthorization_total_amount>
    <capturable_amount>0</capturable_amount>
    <captured_amount>5500</captured_amount>
    <reversed_amount>0</reversed_amount>
    <reversible_amount>0</reversible_amount>
    <arn>74537605259536043849425</arn>
  </payment_response>

    Full Reversal

    Full reversal of a preauthorization can be submitted using the standard Void transaction.

    Reconcile request can be used to determine when the preauthorization is about to expire.

    Reconcile Master Preauthorization Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\Reconcile\Transaction');
$request = $genesis->request();

$request
  ->setUniqueId('17af6b2a9c0eecff061e6eecf9214d53');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.reconcile.ReconcileRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    ReconcileRequest request = new ReconcileRequest();

    request.setUniqueId("17af6b2a9c0eecff061e6eecf9214d53");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.reconcile(
  {
    "unique_id": "17af6b2a9c0eecff061e6eecf9214d53"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/reconcile/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <reconcile>
    <unique_id>17af6b2a9c0eecff061e6eecf9214d53</unique_id>
  </reconcile>'

    Successful Preauthorization Reconciliation Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [authorization_code] => 005645
    [response_code] => 00
    [unique_id] => 17af6b2a9c0eecff061e6eecf9214d53
    [transaction_id] => 119643250547501c79d8295
    [mode] => live
    [timestamp] => 2019-09-16T15:39:09Z
    [descriptor] => Descriptor one
    [amount] => 3000
    [currency] => USD
    [card_brand] => master
    [card_number] => 555555...4444
    [sent_to_acquirer] => true
    [preauthorization] => true
    [preauthorization_expires_at] => 2019-10-16T15:39:09Z
    [preauthorization_total_amount] => 5000
    [capturable_amount] => 5000
    [captured_amount] => 0
    [reversed_amount] => 0
    [reversible_amount] => 5000
    [arn] => 74537605259536043849425
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <authorization_code content=[005645]>
    <response_code content=[00]>
    <unique_id content=[17af6b2a9c0eecff061e6eecf9214d53]>
    <transaction_id content=[119643250547501c79d8295]>
    <mode content=[live]>
    <timestamp content=[2019-09-16T15:39:09Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[3000]>
    <currency content=[USD]>
    <card_brand content=[master]>
    <card_number content=[555555...4444]>
    <sent_to_acquirer content=[true]>
    <preauthorization content=[true]>
    <preauthorization_expires_at content=[2019-10-16T15:39:09Z]>
    <preauthorization_total_amount content=[5000]>
    <capturable_amount content=[5000]>
    <captured_amount content=[0]>
    <reversed_amount content=[0]>
    <reversible_amount content=[5000]>
    <arn content=[74537605259536043849425]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    authorization_code: "005645",
    response_code: "00",
    unique_id: "17af6b2a9c0eecff061e6eecf9214d53",
    transaction_id: "119643250547501c79d8295",
    mode: "live",
    timestamp: "2019-09-16T15:39:09Z",
    descriptor: "Descriptor one",
    amount: "3000",
    currency: "USD",
    card_brand: "master",
    card_number: "555555...4444",
    sent_to_acquirer: "true",
    preauthorization: "true",
    preauthorization_expires_at: "2019-10-16T15:39:09Z",
    preauthorization_total_amount: "5000",
    capturable_amount: "5000",
    captured_amount: "0",
    reversed_amount: "0",
    reversible_amount: "5000",
    arn: "74537605259536043849425",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_response>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <authorization_code>005645</authorization_code>
    <response_code>00</response_code>
    <unique_id>17af6b2a9c0eecff061e6eecf9214d53</unique_id>
    <transaction_id>119643250547501c79d8295</transaction_id>
    <mode>live</mode>
    <timestamp>2019-09-16T15:39:09Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>3000</amount>
    <currency>USD</currency>
    <card_brand>master</card_brand>
    <card_number>555555...4444</card_number>
    <sent_to_acquirer>true</sent_to_acquirer>
    <preauthorization>true</preauthorization>
    <preauthorization_expires_at>2019-10-16T15:39:09Z</preauthorization_expires_at>
    <preauthorization_total_amount>5000</preauthorization_total_amount>
    <capturable_amount>5000</capturable_amount>
    <captured_amount>0</captured_amount>
    <reversed_amount>0</reversed_amount>
    <reversible_amount>5000</reversible_amount>
    <arn>74537605259536043849425</arn>
  </payment_response>

    Partial Reversal

    Partial reversal transactions are used in the preauthorization workflow to release a part of the total authorized amount. A transaction of this type should refer to the preauthorization directly.

    Extend Preauthorization Timeframe & Amount

    Partial Reversal Request Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Preauthorization\PartialReversal');
$request = $genesis->request();

$request
  ->setTransactionId('TrxID_bc4bb9734996aaac9bb649c442d0850b')
  ->setUsage('40208 hotel reservation changed')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('500')
  ->setReferenceId('17af6b2a9c0eecff061e6eecf9214d53');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>partial_reversal</transaction_type>
    <transaction_id>TrxID_bc4bb9734996aaac9bb649c442d0850b</transaction_id>
    <usage>40208 hotel reservation changed</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>500</amount>
    <reference_id>17af6b2a9c0eecff061e6eecf9214d53</reference_id>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    transaction_type required string(255) The transaction type: partial_reversal
    transaction_id required string(255) Unique transaction id defined by merchant
    usage required* string(255) Description of the transaction for later use
    remote_ip required* IPv4 or IPv6 address IPv4 or IPv6 address of customer
    amount required integer > 0 The amount to be reversed in minor currency unit, see Currency and Amount Handling for details.
    reference_id required string(32) Unique id of the corresponding preauthorization transaction

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => partial_reversal
    [status] => approved
    [authorization_code] => 629324
    [response_code] => 00
    [transaction_id] => TrxID_bc4bb9734996aaac9bb649c442d0850b
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:10.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [mode] => live
    [descriptor] => Descriptor one
    [amount] => 500
    [currency] => USD
    [sent_to_acquirer] => true
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>partial_reversal</transaction_type>
    <status>approved</status>
    <authorization_code>629324</authorization_code>
    <response_code>00</response_code>
    <transaction_id>TrxID_bc4bb9734996aaac9bb649c442d0850b</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <timestamp>2019-09-17T15:39:10Z</timestamp>
    <mode>live</mode>
    <descriptor>Descriptor one</descriptor>
    <amount>500</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_transaction>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    gaming string Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto string Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    authorization_code string(6) Generated by the card network when an authorisation has occurred, used to identify that auth. Consists of 6 alphanumeric chars
    response_code string(2) Defines the issuer result of a transaction, the status of a message or some action taken or required. See issuer response codes for details
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    partial_approval string(4) Optional, set to ’true’ if partial approval happened. Partially approved amount is then in the amount field. Check Partial Approvals for details
    sent_to_acquirer string "true" or "false"

    Error Response

    stdClass Object
(
    [transaction_type] => partial_reversal
    [status] => error
    [mode] => live
    [transaction_id] => TrxID_bc4bb9734996aaac9bb649c442d0850b
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 410
    [technical_message] => No approved preauthorization reference transaction found
    [message] => Something went wrong, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:10.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [descriptor] => Descriptor one
    [amount] => 500
    [currency] => USD
    [sent_to_acquirer] => false
)

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>partial_reversal</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>TrxID_bc4bb9734996aaac9bb649c442d0850b</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>410</code>
    <technical_message>No approved preauthorization reference transaction found</technical_message>
    <message>Something went wrong, please contact support!</message>
    <timestamp>2019-09-17T15:39:10Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>500</amount>
    <currency>USD</currency>
    <sent_to_acquirer>false</sent_to_acquirer>
  </payment_transaction>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    transaction_id string(255) Unique transaction id defined by merchant
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    descriptor string Static descriptor MID info as configured on the gateway
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    sent_to_acquirer string "true" or "false"

    Required vs Optional API params

    There are some API params which can be configured as either optional or required on the terminal level. Contact the IT Support team at tech-support@e-comprocessing.com if you wish to disable or enable some API params based on your business model and integration type. Note also that if all the billing address params are configured as optional, then the whole billing address XML tag can be dismissed and not sent in the API requests.

    Name Type Description
    customer_email email address By default, customer email is a required API param
    customer_phone string(32) By default, customer phone is an optional API param
    remote_ip string(40) By default, customer IP is a required API param
    first_name string(255) By default, customer first name is a required API param
    last_name string(255) By default, customer last name is a required API param
    address1 string(255) By default, primary address is a required API param. Cannot be configured as optional for account verification transaction type
    address2 string(255) By default, secondary address is an optional API param
    city string(255) By default, city is a required API param. Cannot be config- ured as optional for account verification transaction type
    zip_code string By default, zip code is a required API param. Cannot be con- figured as optional for account verification transaction type
    state string(2) By default, state is an optional API param (unless country is US or CA)
    country string(2) By default, country code is a required API param
    usage string(255) By default, usage will be configured as a required API param for SDD and P24, optional for the rest

    Transaction States

    Transactions will have one of the following states. These will be returned by transaction responses, reconcile responses and will be shown in the browser interface

    Status Description
    approved Transaction was approved by the schemes and is successful.
    declined Transaction was declined by the schemes or risk management.
    pending_async An asynchronous transaction (3-D secure payment) has been initiated and is waiting for user input. Updates of this state will be sent to the notification url specified in request.
    pending The outcome of the transaction could not be determined, e.g. at a timeout situation. Transaction state will eventually change, so make a reconcile after a certain time frame.
    error An error has occurred while negotiating with the schemes.
    refunded Once an approved transaction is refunded the state changes to refunded.
    chargebacked Once an approved transaction is chargebacked - the state changes to changebacked. Chargeback is the state of rejecting an accepted transaction (with funds transferred) by the cardholder or the issuer
    voided Transaction was authorized, but later the merchant canceled it.
    chargeback_reversed Once a chargebacked transaction is charged, the state changes to chargeback reversed. Chargeback has been canceled.
    represented Once a chargebacked transaction is charged, the state changes to represented. Chargeback has been canceled.
    second_chargebacked Once a chargeback_reversed/represented transaction is chargebacked the state changes to second chargebacked.
    pending_review Transaction on hold, a manual review will be done

    Supported Card Brands

    Card Brands are specific per acquirer. If you want to use a specific card brand you can contact tech-support@e-comprocessing.com.

    Supported card brands
    Visa
    Master
    Intl Maestro
    Discover
    Diners
    AMEX
    JCB
    RuPay
    Elo
    Aura
    Hipercard

    Document ID Parameter

    Document ID is consumer personal identification. It is different for every country and is described more specifically in the table below. Document ID is required for some of the acquirers, please contact the IT Support team at tech-support@e-comprocessing.com for more information.

    Country Name Type Description
    Argentina document_id string(255) Consumer's Argentinian Identification Number(DNI or CUIT). Must be string between 7 to 9, or 11 digits.
    Brazil document_id string(255) Consumer's Brazilian Identification Number(CPF or CNPJ). Must be string between 11 and 14 digits and to have full cpf validation. Example: 76484475687
    Chile document_id string(255) Consumer's Chilean Identification Number(CI/RUT). Must be string between 8 to 9 digits.
    Colombia document_id string(255) Consumer's Colombian Identification Number(CC). Must be string between 6 to 10 digits.
    India document_id string(255) Consumer's Indian PAN. Must be string with 10 alphanumeric letters. 5 letters, followed by 4 numbers, followed by 1 letter or number. Example: ABCDE1234F
    Mexico document_id string(255) Consumer's Mexican Identification Number(CURP). Must be string between 10 and 18 digits.
    Paraguay document_id string(255) Consumer's Paraguayan Identification Number(CI). Must be string between 5 and 20 digits.
    Peru document_id string(255) Consumer's Peruvian Identification Number(DNI). Must be string between 8 and 9 digits.
    Turkey document_id string(255) Consumer's Turkish Identification Number(T.C. Kimlik No.). Must be string between 5 and 20 digits.
    Uruguay document_id string(255) Consumer's Uruguayan Identification Number(CI). Must be string between 6 and 8 digits.

    Business Attributes

    Business attributes are groups of additional risk attributes which are in close relation with the merchant business category. Some/All of them can be required at our risk team's discretion and will be used for internal reporting only. These business attributes can be submitted with a standard card transaction on Processing API and WPF processing.

    Business categories:

    Segment MCC
    Event Management
    Consulting, Public Relations 7392
    Miscellaneous General Services 7299
    Theatrical Ticket Agencies 7922
    Direct Marketing - Other 5969
    Furniture
    Furniture, Home Furnishings, and Equipment Stores, Except Appliances 5712
    Office and Commercial Furniture 5021

    Specific attributes for each business category can be found in the following table:

    Attribute Type Description
    Event Management
    event_start_date string The date when event starts in format dd-mm-yyyy
    event_end_date string The date when event ends in format dd-mm-yyyy
    event_organizer_id string
    event_id string
    Furniture
    date_of_order string The date when order was placed in format dd-mm-yyyy
    delivery_date string Date of the expected delivery in format dd-mm-yyyy
    name_of_the_supplier string

    Transaction types with business attributes:

    Reconcile

    Reconcile can be used to retrieve data about a transaction. This can be useful if you want to retrieve information about a transaction whose status is timeout, which returned an error or has changed eg. has beed chargebacked.

    Reconcile request are handled exactly like transaction requests via XML.

    Single Transaction

    The URL for single transaction reconciling is similar to the processing url:

    https://username:password@staging.gate.e-comprocessing.net/reconcile/TERMINAL-TOKEN

    Reconcile By Unique Id Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\Reconcile\Transaction');
$request = $genesis->request();

$request
  ->setUniqueId('44177a21403427eb96664a6d7e5d5d48');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.reconcile.ReconcileRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    ReconcileRequest request = new ReconcileRequest();

    request.setUniqueId("44177a21403427eb96664a6d7e5d5d48");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.reconcile(
  {
    "unique_id": "44177a21403427eb96664a6d7e5d5d48"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/reconcile/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <reconcile>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
  </reconcile>'

    Reconcile By Arn Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\Reconcile\Transaction');
$request = $genesis->request();

$request
  ->setArn('74537605248535042582882');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.reconcile.ReconcileRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    ReconcileRequest request = new ReconcileRequest();

    request.setArn("74537605248535042582882");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.reconcile(
  {
    "arn": "74537605248535042582882"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/reconcile/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <reconcile>
    <arn>74537605248535042582882</arn>
  </reconcile>'

    Reconcile By Transaction Id Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\Reconcile\Transaction');
$request = $genesis->request();

$request
  ->setTransactionId('merchant-transaction-id-here');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.reconcile.ReconcileRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    ReconcileRequest request = new ReconcileRequest();

    request.setTransactionId("merchant-transaction-id-here");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.reconcile(
  {
    "transaction_id": "merchant-transaction-id-here"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/reconcile/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <reconcile>
    <transaction_id>merchant-transaction-id-here</transaction_id>
  </reconcile>'

    XML Request to reconcile:

    Note that reconcile can be done via either unique_id, ARN or transaction_id

    XML Response:

    Response is a standard payment response like it would be returned by any transaction. It can have either state as shown in the states section.

    Successful Sale Transaction Reconciliation Response

    stdClass Object
(
    [transaction_type] => sale
    [status] => approved
    [authorization_code] => 005645
    [response_code] => 00
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [transaction_id] => 119643250547501c79d8295
    [mode] => live
    [timestamp] => 2019-09-17T15:39:10Z
    [descriptor] => Descriptor one
    [amount] => 9000
    [currency] => USD
    [card_brand] => visa
    [card_number] => 420000...0000
    [sent_to_acquirer] => true
    [arn] => 74537605259536043849425
)

    <payment_response content=[
    <transaction_type content=[sale]>
    <status content=[approved]>
    <authorization_code content=[005645]>
    <response_code content=[00]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <transaction_id content=[119643250547501c79d8295]>
    <mode content=[live]>
    <timestamp content=[2019-09-17T15:39:10Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[9000]>
    <currency content=[USD]>
    <card_brand content=[visa]>
    <card_number content=[420000...0000]>
    <sent_to_acquirer content=[true]>
    <arn content=[74537605259536043849425]>
]>

    {
    transaction_type: "sale",
    status: "approved",
    authorization_code: "005645",
    response_code: "00",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    transaction_id: "119643250547501c79d8295",
    mode: "live",
    timestamp: "2019-09-17T15:39:10Z",
    descriptor: "Descriptor one",
    amount: "9000",
    currency: "USD",
    card_brand: "visa",
    card_number: "420000...0000",
    sent_to_acquirer: "true",
    arn: "74537605259536043849425",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_response>
    <transaction_type>sale</transaction_type>
    <status>approved</status>
    <authorization_code>005645</authorization_code>
    <response_code>00</response_code>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <transaction_id>119643250547501c79d8295</transaction_id>
    <mode>live</mode>
    <timestamp>2019-09-17T15:39:10Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>9000</amount>
    <currency>USD</currency>
    <card_brand>visa</card_brand>
    <card_number>420000...0000</card_number>
    <sent_to_acquirer>true</sent_to_acquirer>
    <arn>74537605259536043849425</arn>
  </payment_response>

    Successful Refund Transaction Reconciliation Response

    stdClass Object
(
    [transaction_type] => refund
    [status] => approved
    [authorization_code] => 005645
    [response_code] => 00
    [unique_id] => 5de39380bf7ac7e1fc31cbd7805dc0ec
    [transaction_id] => 119643250547501c79d8295
    [mode] => live
    [timestamp] => 2019-09-17T15:39:10Z
    [descriptor] => Descriptor one
    [amount] => 9000
    [currency] => USD
    [card_brand] => visa
    [card_number] => 420000...0000
    [sent_to_acquirer] => true
    [reference_transaction_unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [arn] => 74537605259536043849425
)

    <payment_response content=[
    <transaction_type content=[refund]>
    <status content=[approved]>
    <authorization_code content=[005645]>
    <response_code content=[00]>
    <unique_id content=[5de39380bf7ac7e1fc31cbd7805dc0ec]>
    <transaction_id content=[119643250547501c79d8295]>
    <mode content=[live]>
    <timestamp content=[2019-09-17T15:39:10Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[9000]>
    <currency content=[USD]>
    <card_brand content=[visa]>
    <card_number content=[420000...0000]>
    <sent_to_acquirer content=[true]>
    <reference_transaction_unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <arn content=[74537605259536043849425]>
]>

    {
    transaction_type: "refund",
    status: "approved",
    authorization_code: "005645",
    response_code: "00",
    unique_id: "5de39380bf7ac7e1fc31cbd7805dc0ec",
    transaction_id: "119643250547501c79d8295",
    mode: "live",
    timestamp: "2019-09-17T15:39:10Z",
    descriptor: "Descriptor one",
    amount: "9000",
    currency: "USD",
    card_brand: "visa",
    card_number: "420000...0000",
    sent_to_acquirer: "true",
    reference_transaction_unique_id: "44177a21403427eb96664a6d7e5d5d48",
    arn: "74537605259536043849425",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_response>
    <transaction_type>refund</transaction_type>
    <status>approved</status>
    <authorization_code>005645</authorization_code>
    <response_code>00</response_code>
    <unique_id>5de39380bf7ac7e1fc31cbd7805dc0ec</unique_id>
    <transaction_id>119643250547501c79d8295</transaction_id>
    <mode>live</mode>
    <timestamp>2019-09-17T15:39:10Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>9000</amount>
    <currency>USD</currency>
    <card_brand>visa</card_brand>
    <card_number>420000...0000</card_number>
    <sent_to_acquirer>true</sent_to_acquirer>
    <reference_transaction_unique_id>44177a21403427eb96664a6d7e5d5d48</reference_transaction_unique_id>
    <arn>74537605259536043849425</arn>
  </payment_response>

    Preauthorization

    Name Type Description
    preauthorization "true" Preauthorization flag
    preauthorization_expires_at string Preauthorization expiration date time in ISO 8601 Combined date and time, e.g. 2007-08-30T17:46:11Z
    preauthorization_total_amount integer Total preauthorization amount (initial + topup amount)
    capturable_amount integer The total amount that can be captured
    captured_amount integer The total captured amount
    reversed_amount integer The total reversed amount
    reversible_amount integer The total reversible amount

    Successful Preauthorization Reconciliation Response

    stdClass Object
(
    [transaction_type] => authorize
    [status] => approved
    [authorization_code] => 005645
    [response_code] => 00
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [transaction_id] => 119643250547501c79d8295
    [mode] => live
    [timestamp] => 2019-09-17T15:39:10Z
    [descriptor] => Descriptor one
    [amount] => 5000
    [currency] => USD
    [card_brand] => master
    [card_number] => 555555...4444
    [sent_to_acquirer] => true
    [preauthorization] => true
    [preauthorization_expires_at] => 2019-10-18T18:39:10+03:00
    [preauthorization_total_amount] => 10000
    [capturable_amount] => 8000
    [captured_amount] => 0
    [reversed_amount] => 2000
    [reversible_amount] => 8000
    [arn] => 74537605259536043849425
)

    <payment_response content=[
    <transaction_type content=[authorize]>
    <status content=[approved]>
    <authorization_code content=[005645]>
    <response_code content=[00]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <transaction_id content=[119643250547501c79d8295]>
    <mode content=[live]>
    <timestamp content=[2019-09-17T15:39:10Z]>
    <descriptor content=[Descriptor one]>
    <amount content=[5000]>
    <currency content=[USD]>
    <card_brand content=[master]>
    <card_number content=[555555...4444]>
    <sent_to_acquirer content=[true]>
    <preauthorization content=[true]>
    <preauthorization_expires_at content=[2019-10-18T18:39:10+03:00]>
    <preauthorization_total_amount content=[10000]>
    <capturable_amount content=[8000]>
    <captured_amount content=[0]>
    <reversed_amount content=[2000]>
    <reversible_amount content=[8000]>
    <arn content=[74537605259536043849425]>
]>

    {
    transaction_type: "authorize",
    status: "approved",
    authorization_code: "005645",
    response_code: "00",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    transaction_id: "119643250547501c79d8295",
    mode: "live",
    timestamp: "2019-09-17T15:39:10Z",
    descriptor: "Descriptor one",
    amount: "5000",
    currency: "USD",
    card_brand: "master",
    card_number: "555555...4444",
    sent_to_acquirer: "true",
    preauthorization: "true",
    preauthorization_expires_at: "2019-10-18T18:39:10+03:00",
    preauthorization_total_amount: "10000",
    capturable_amount: "8000",
    captured_amount: "0",
    reversed_amount: "2000",
    reversible_amount: "8000",
    arn: "74537605259536043849425",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <payment_response>
    <transaction_type>authorize</transaction_type>
    <status>approved</status>
    <authorization_code>005645</authorization_code>
    <response_code>00</response_code>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <transaction_id>119643250547501c79d8295</transaction_id>
    <mode>live</mode>
    <timestamp>2019-09-17T15:39:10Z</timestamp>
    <descriptor>Descriptor one</descriptor>
    <amount>5000</amount>
    <currency>USD</currency>
    <card_brand>master</card_brand>
    <card_number>555555...4444</card_number>
    <sent_to_acquirer>true</sent_to_acquirer>
    <preauthorization>true</preauthorization>
    <preauthorization_expires_at>2019-10-18T18:39:10+03:00</preauthorization_expires_at>
    <preauthorization_total_amount>10000</preauthorization_total_amount>
    <capturable_amount>8000</capturable_amount>
    <captured_amount>0</captured_amount>
    <reversed_amount>2000</reversed_amount>
    <reversible_amount>8000</reversible_amount>
    <arn>74537605259536043849425</arn>
  </payment_response>

    By date range

    Date range based reconciliation allows you to fetch information for all payment transactions from a terminal within a given date range. The response is paginated, each request will return 100 entries max.

    The URL for date range reconciling is:

    https://username:password@staging.gate.e-comprocessing.net/reconcile/by_date/TERMINAL-TOKEN

    Reconcile By Date Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('NonFinancial\Reconcile\DateRange');
$request = $genesis->request();

$request
  ->setStartDate('2014-01-01')
  ->setEndDate('2014-01-31')
  ->setPage('2');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.nonfinancial.reconcile.ReconcileByDate;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    ReconcileByDate request = new ReconcileByDate();

    request.setStartDate("2014-01-01");
    request.setEndDate("2014-01-31");
    request.setPage("2");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.reconcile_by_date(
  {
    "start_date": "2014-01-01",
    "end_date": "2014-01-31",
    "page": 2
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/reconcile/by_date/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <reconcile>
    <start_date>2014-01-01</start_date>
    <end_date>2014-01-31</end_date>
    <page>2</page>
  </reconcile>'
    Parameter Required Format Description
    start_date required yyyy-mm-dd start of the requested date range
    end_date optional yyyy-mm-dd end of the requested date range
    page optional integer the page within the paginated result, defaults to 1

    Response:

    The attributes in the root node payment responses include information about the pagination of the response.

    <?xml version="1.0" encoding="UTF-8"?>
<payment_responses per_page="100" page="2" total_count="19" pages_count="7">
  <payment_response>
    <transaction_type>sale</transaction_type>
    <status>approved</status>
    <authorization_code>005645</authorization_code>
    <response_code>00</response_code>
    <unique_id>130319cfb3bf65ff3c4a4045487b174f</unique_id>
    <transaction_id>EFBFBC7D-82CD-4375-9A69-15F19C88A134</transaction_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <mode>live</mode>
    <timestamp>2014-01-03T15:04:00Z</timestamp>
    <descriptor>descriptor one</descriptor>
    <amount>500</amount>
    <currency>USD</currency>
    <card_brand>visa</card_brand>
    <card_number>420000...0000</card_number>
    <card_holder>John Doe</card_holder>
    <expiration_year>2020</expiration_year>
    <expiration_month>2</expiration_month>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_response>
  <payment_response>
    <transaction_type>sale</transaction_type>
    <status>approved</status>
    <authorization_code>638745</authorization_code>
    <response_code>00</response_code>
    <unique_id>130319cfb3bf65ff3c4a4045487b173f</unique_id>
    <transaction_id>BBD7945B-BE57-4A14-A7FB-47F7AE928D95</transaction_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <mode>live</mode>
    <timestamp>2014-01-05T15:04:00Z</timestamp>
    <descriptor>descriptor one</descriptor>
    <amount>500</amount>
    <currency>USD</currency>
    <card_brand>visa</card_brand>
    <card_number>420000...0000</card_number>
    <card_holder>John Doe</card_holder>
    <expiration_year>2020</expiration_year>
    <expiration_month>2</expiration_month>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_response>
  <payment_response>
    <transaction_type>sale</transaction_type>
    <status>approved</status>
    <authorization_code>226534</authorization_code>
    <response_code>00</response_code>
    <unique_id>1e8a6f09253eb8b4f8c84c0d8803713e</unique_id>
    <transaction_id>_5041_2013041012_22_10_545</transaction_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <mode>live</mode>
    <timestamp>2013-01-09T10:22:13Z</timestamp>
    <descriptor>test_descriptor</descriptor>
    <amount>50422</amount>
    <currency>EUR</currency>
    <card_brand>visa</card_brand>
    <card_number>420000...0000</card_number>
    <card_holder>John Doe</card_holder>
    <expiration_year>2020</expiration_year>
    <expiration_month>2</expiration_month>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_response>
  <payment_response>
    <transaction_type>sale3d</transaction_type>
    <status>pending_async</status>
    <unique_id>5dbdb4c677ee16b8fb1e43483164be2c</unique_id>
    <transaction_id>_6547_2013041012_23_08_470</transaction_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.gate.e-comprocessing.net/redirect/to_acquirer/5dbdb4c677</redirect_url>
    <mode>live</mode>
    <timestamp>2014-01-10T10:23:10Z</timestamp>
    <descriptor>test_descriptor</descriptor>
    <amount>100</amount>
    <currency>EUR</currency>
    <card_brand>visa</card_brand>
    <card_number>471110...0000</card_number>
    <card_holder>John Doe</card_holder>
    <expiration_year>2020</expiration_year>
    <expiration_month>2</expiration_month>
    <sent_to_acquirer>true</sent_to_acquirer>
  </payment_response>
  <payment_response>
    <transaction_type>refund</transaction_type>
    <status>approved</status>
    <authorization_code>005645</authorization_code>
    <response_code>00</response_code>
    <unique_id>44177a21403427eb96664a6d7e5d5d49</unique_id>
    <transaction_id>119643250547501c79d8296</transaction_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <mode>test</mode>
    <timestamp>2014-01-30T14:21:48Z</timestamp>
    <descriptor>descriptor one</descriptor>
    <amount>9000</amount>
    <currency>USD</currency>
    <sent_to_acquirer>true</sent_to_acquirer>
    <reference_transaction_unique_id>44177a21403427eb96664a6d7e5d5d48</reference_transaction_unique_id>
   </payment_response>
  ...
</payment_responses>
    Name Type Description
    @per_page integer number of entries per page
    @page integer the current page
    @total_count integer total number of all entries
    @pages_count integer total number of pages

    Processed Transactions

    Processed Transaction API

    The Processed Transaction API can be used to retrieve data about processed transactions.

    Single Processed Transaction

    Single processed transaction retrieval allows to get a certain processed transaction by its ARN or by passing its unique ID.

    <?xml version="1.0" encoding="UTF-8"?>
<processed_transaction_request>
  <arn>74537604221431003881865</arn>
</processed_transaction_request>

    OR

    <?xml version="1.0" encoding="UTF-8"?>
<processed_transaction_request>
  <unique_id>53b1f5eacc9e4d3a3afebb4e993fe962</unique_id>
</processed_transaction_request>

    The URLs for the single processed transaction API are:

    Production: https://gate.e-comprocessing.net/processed_transactions

    Staging (for integration): https://staging.gate.e-comprocessing.net/processed_transactions










    <?xml version="1.0" encoding="UTF-8"?>
<processed_transaction_response>
  <merchant_number>124000000006698</merchant_number>
  <batch_number>eMP</batch_number>
  <transaction_date>2019-09-01 16:43:02 UTC</transaction_date>
  <post_date>2019-09-01</post_date>
  <terminal_id/>
  <auth_code>09117B</auth_code>
  <currency>USD</currency>
  <amount>36.90</amount>
  <merchant_reference_transaction>b76e9a54bdc99b3</merchant_reference_transaction>
  <arn>85301169244934771128812</arn>
  <card_brand>MC World Signia</card_brand>
  <bin_country>124</bin_country>
  <service_type_desc>Credit Card</service_type_desc>
  <merchant_country>826</merchant_country>
  <area_of_event>Foreign - MASTER</area_of_event>
  <cross_rate>1</cross_rate>
  <card_scheme>Mastercard</card_scheme>
  <unique_id>b76e9a54bdc99b338068681727ed5e240000</unique_id>
  <card_present>false</card_present>
  <fees>
   <fee>
     <type>Assessment fee</type>
     <amount>-0.74</amount>
     <currency>USD</currency>
     <charge_amount>-0.74</charge_amount>
     <charge_currency>USD</charge_currency>
    </fee>
    <fee>
      <type>Merchant Price Interchange</type>
      ....
    </fee>
    ....
  </fees>
</processed_transaction_response>

    Response parameters:

    Name Type Description
    merchant_number string(20) Merchant number
    batch_number string(23) Batch number
    transaction_date string Transaction date in date and time format
    post_date string Posting date
    terminal_id string(10) Terminal ID
    amount float(18, 2) Transaction amount in transaction currency
    arn string(23) Acquirer reference number
    merchant_reference_transaction string(23) Merchant's transaction reference number
    card_scheme string(16) Descriptive text for the card scheme
    service_type_desc string(25) Indicates if transaction is a Debit or Credit transaction
    card_brand string(16) Scheme card brand
    bin_country string(3) Issuing BIN ISO Country Code from Scheme BIN tables
    merchant_country string(3) 3 digit ISO country code of the merchant country
    area_of_event string(19) Area of event
    currency string(3) Currency of transaction
    cross_rate float(11) FX rate to convert from transaction account to merchant funding currency
    auth_code string(6) Authorization code
    unique_id string(36) Unique Transaction Identifier is generated at PoS before sent for authorisation or offline approval
    card_present boolean Transaction is card present or card not present
    fees
       type string(65) Transaction type for the related charge posted to account
       amount float(21) Calculated charge amount in transaction currency
       currency string(3) Currency of transaction
       charge_amount float(21) Calculated charge amount in charge currency
       charge_currency string(3) Currency of charge 
    <?xml version="1.0" encoding="UTF-8"?>
<processed_transaction_response>
    <status>error</status>
    <code>465</code>
    <message>Processed transaction not found!</message>
    <technical_message>Processed transaction by the given criteria cannot be found!</technical_message>
</processed_transaction_response>

    In case no processed transaction is found for the given ARN or unique ID, a corresponding XML response is as follows:

    By date or post date range

    Date range based processed transaction retrieval allows you to fetch information for all processed transactions for a given merchant within a given date range. Date range searches for processed transactions either by their creation or posting date. The response is paginated, each request will return 100 entries max.

    The URLs for date range processed transaction retrieval are:

    Production: https://gate.e-comprocessing.net/processed transactions/by_date https://gate.e-comprocessing.net/processed transactions/by_post_date

    Staging (for integration): https://staging.gate.e-comprocessing.net/processed transactions/by_date https://staging.gate.e-comprocessing.net/processed transactions/by_post_date

    Request parameters:

    <?xml version="1.0" encoding="UTF-8"?>
<processed_transaction_request>
  <start_date>2014-01-01</start_date>
  <end_date>2014-01-31</end_date>
  <card_present>true</card_present>
  <batch_number>2065063</batch_number>
  <page>2</page>
</processed_transaction_request>
    Parameter Required Format Description
    start_date required yyyy-mm-dd start of the requested date range
    end_date optional yyyy-mm-dd end of the requested date range
    page optional integer the page within the paginated result, defaults to '1'
    per_page optional integer Number of entities on page, defaults to '100'
    card_present optional boolean True/false value filtering transactions by Card Present or Card Not Present type, defaults to 'false'
    batch_number optional string Batch number of processed transactions (only for 'by_post_date' API call)

    Response parameters:

    <?xml version="1.0" encoding="UTF-8"?>
<processed_transaction_responses per_page="100" page="2" total_count="19" pages_count="7">
  <processed_transaction_response>
    <merchant_number>106000000000068</merchant_number>
    <batch_number>eMP</batch_number>
    <transaction_date>2019-09-03 11:03:04 UTC</transaction_date>
    <post_date>2014-07-06</post_date>
    <terminal_id/>
    <amount>1</amount>
    <arn>84970008d07822c</arn>
    <merchant_reference_transaction>397ac21c08fe281afffabd8</merchant_reference_transaction>
    <card_scheme>Visa</card_scheme>
    <service_type_desc>Debit Card</service_type_desc>
    <card_brand>VISA.</card_brand>
    <bin_country>643</bin_country>
    <merchant_country>292</merchant_country>
    <area_of_event>Foreign - REST</area_of_event>
    <currency>USD</currency>
    <cross_rate>.0127015</cross_rate>
    <auth_code>2</auth_code>
    <unique_id>397ac21c08fe281afffabd8aa5265e76</unique_id>
    <card_present>false</card_present>
    <fees/>
  </processed_transaction_response>
  <processed_transaction_response>
    <merchant_number>106000000000068</merchant_number>
    <batch_number>eMP</batch_number>
    <transaction_date>2019-09-03 11:03:04 UTC</transaction_date>
    <post_date>2014-07-06</post_date>
    <terminal_id/>
    <amount>1</amount>
    <arn>84970008d07822c</arn>
    <merchant_reference_transaction>397ac21c08fe281afffabd8</merchant_reference_transaction>
    <card_scheme>Visa</card_scheme>
    <service_type_desc>Debit Card</service_type_desc>
    <card_brand>VISA.</card_brand>
    <bin_country>643</bin_country>
    <merchant_country>292</merchant_country>
    <area_of_event>Foreign - REST</area_of_event>
    <currency>USD</currency>
    <cross_rate>.0127015</cross_rate>
    <auth_code>2</auth_code>
    <unique_id>397ac21c08fe281afffabd8aa5265e76</unique_id>
    <card_present>false</card_present>
    <fees>
      <fee>
        <type>Per Tran Fee</type>
        <amount>-0.1</amount>
        <currency>GBP</currency>
        <charge_amount>-0.1</charge_amount>
        <charge_currency>GBP</charge_currency>
      </fee>
    </fees>
  </processed_transaction_response>
  ...
</processed_transaction_responses>

    The attributes in the root node processed transaction responses includes information about the pagination of the response.

    Name Type Description
    @per_page integer number of entries per page
    @page integer the current page
    @total_count integer total number of all entries
    @pages_count integer total number of pages

    Chargebacks

    Chargebacks are a special type of transactions as they cannot be triggered by the merchant. Charge- backs occur if a customer disputes to an item of his credit card bill at his issuing bank and the bank requests a chargeback. In this case, the amount is automatically refunded to the customers cc account and deducted from your merchant account.

    Customers who initiate chargebacks will automatically be blocked for future transactions. For details, please contact our Risk team.

    You can also see a chargeback overview in the merchant console under the Risk Management menu.

    Chargeback reversals

    The reversals could be split into two types. These are the chargeback reversals, which appear when the a chargeback dispute is cancelled (withdrawn) by the consumer/issuer and the representments, which appear when the merchant or the acquirer disputes an already received chargeback. Both of these chargeback event types are handled properly and integrated into the whole process of chargeback dispute procedure.

    Chargeback notifications

    You now have the option to receive API and/or email notifications for each chargeback event that occurs - e.g. for first chargebacks, second chargebacks, and representments. Enable this feature by emailing the IT Support team at tech-support@e-comprocessing.com with the chargeback notification URL if needed.

    The email notifications are sent to the merchant user with role ’admin’ which is configured for managing the merchant entity on the gateway platform. The API notifications are equal to Notification for asynchronous payments, please refer to the section Notification for asynchronous payments to understand how notifications work.

    Chargeback Notification Example

    ?transaction_id=343d9040a671c45832ee5381860e2996
&terminal_token=f4266042a6131b666060beb75691341d78ee5b4f
&unique_id=57ff74d1ca8727f59f243de6d01ff027
&transaction_type=sale
&status=chargebacked
&signature=ab4348afa9830834df90069646e4ce66c39a5358
&amount=100
&event=chargeback

    Chargeback API

    The Chargeback API can be used to retrieve data about chargebacks.

    Single Chargeback

    Single chargeback retrieval allows to get a certain chargeback by its ARN or by passing the unique ID of the original transaction.

    <?xml version="1.0" encoding="UTF-8"?>
<chargeback_request>
  <arn>74537604221431003881865</arn>
</chargeback_request>

    OR

    <?xml version="1.0" encoding="UTF-8"?>
<chargeback_request>
  <original_transaction_unique_id>53b1f5eacc9e4d3a3afebb4e993fe962</original_transaction_unique_id>
</chargeback_request>

    The URLs for the single chargeback API are:

    Production: https://gate.e-comprocessing.net/chargebacks

    Staging (for integration): https://staging.gate.e-comprocessing.net/chargebacks










    <?xml version="1.0" encoding="UTF-8"?>
<chargeback_response>
  <type>1st Chargeback </type>
  <arn>74537604221431003881865</arn>
  <post_date>2014-01-24</post_date>
  <reason_code>4855</reason_code>
  <reason_description>Non-receipt of merchandise</reason_description>
  <authorization_code>811714</authorization_code>
  <amount>-14625</amount>
  <currency>USD</currency>
  <chargeback_amount>300.0</chargeback_amount>
  <chargeback_currency>EUR</chargeback_currency>
  <card_number>554960******5069</card_number>
  <card_brand>master</card_brand>
  <customer_email>jonh_doe@example.com</customer_email>
  <customer_phone>3598851248512</customer_phone>
  <transaction_type>sale3d</transaction_type>
  <original_transaction_unique_id>f9634ec5e7dbe6ca3871974accb875cd</original_transaction_unique_id>
</chargeback_response>

    Response parameters:

    Name Type Description
    type string The chargeback type. See chargeback types for details
    arn string ARN of the chargeback’s transaction
    post_date string The date of the chargeback
    reason_code string Reason code of the chargeback
    reason_description string Reason description of the chargeback
    authorization_code string Authorization code of the chargeback’s transac- tion
    amount float Amount in the cardholder account currency. Amount can be negative for: 1st chargeback, 2nd chargeback, transfer reversal and positive for all other types.
    currency string(3) Currency of the cardholder account. See ISO 4217
    chargeback_amount float The amount in the chargeback’s transaction currency.
    chargeback_currency string(3) The currency of the chargeback’s transaction. See ISO 4217
    card_number string Card number used for the chargeback’s transaction
    card_brand string Card brand of the card number
    customer_email string The email of the cardholder
    customer_phone integer The phone of the cardholder
    transaction_type string The type of the chargeback’s transaction
    original_transaction_unique_id string The unique id of the chargeback’s transaction 
    <?xml version="1.0" encoding="UTF-8"?>
<chargeback_response>
  <technical_message>Chargeback by the given criteria cannot be found!</technical_message>
  <status>error</status>
  <message>Chargeback not found!</message>
  <code>470</code>
</chargeback_response>

    In case no chargeback is found for the given ARN or unique ID, a corresponding XML response is as follows:

    By date range

    Date range based chargeback retrieval allows you to fetch information for all chargebacks for a given merchant within a given date range. Date range searches for chargebacks by their posting date. Search option is chargeback retrieval by their import (creation) date. The response is paginated, each request will return 100 entries max.

    The URLs for date range chargeback retrieval are:

    Production: https://gate.e-comprocessing.net/chargebacks/by_date

    Staging (for integration): https://staging.gate.e-comprocessing.net/chargebacks/by_date

    Request parameters:

    <?xml version="1.0" encoding="UTF-8"?>
<chargeback_request>
  <start_date>2014-01-01</start_date>
  <end_date>2014-01-31</end_date>
  <page>2</page>
</chargeback_request>
    Parameter Required Format Description
    start_date required yyyy-mm-dd start of the requested date range
    end_date optional yyyy-mm-dd end of the requested date range
    page optional integer the page within the paginated result, defaults to 1

    Response parameters:

    The attributes in the root node chargeback responses includes information about the pagination of the response.

     <?xml version="1.0" encoding="UTF-8"?>
<chargeback_responses per_page="100" page="2" total_count="19" pages_count="7">
  <chargeback_response>
    <type>1st Chargeback</type>
    <arn>74537604221431003881865</arn>
    <post_date>2014-01-24</post_date>
    <reason_code>4855</reason_code>
    <reason_description>Non-receipt of merchandise</reason_description>
    <authorization_code>811714</authorization_code>
    <amount>-14625</amount>
    <currency>USD</currency>
    <chargeback_amount>300.0</chargeback_amount>
    <chargeback_currency>EUR</chargeback_currency>
    <card_number>554960******5069</card_number>
    <card_brand>master</card_brand>
    <customer_email>jonh_doe@example.com</customer_email>
    <customer_phone>3598851248512</customer_phone>
    <transaction_type>sale3d</transaction_type>
    <original_transaction_unique_id>f9634ec5e7dbe6ca3871974accb875cd</original_transaction_unique_id>
  </chargeback_response>
  <chargeback_response>
    <type>2nd Chargeback </type>
    <arn>74537604221431003881862</arn>
    <post_date>2014-01-27</post_date>
    <reason_code>3456</reason_code>
    <reason_description>Credit not processed</reason_description>
    <authorization_code>123456</authorization_code>
    <amount>3456</amount>
    <currency>EUR</currency>
    <chargeback_amount>300.0</chargeback_amount>
    <chargeback_currency>EUR</chargeback_currency>
    <card_number>454360******5008</card_number>
    <card_brand>visa</card_brand>
    <customer_email>jenny_doe@example.com</customer_email>
    <customer_phone>3598851248123</customer_phone>
    <transaction_type>sale</transaction_type>
    <original_transaction_unique_id>67fbebc172b743a164a3f3af3d010457</original_transaction_unique_id>
  </chargeback_response>
  ...
</chargeback_responses>
    Name Type Description
    @per_page integer number of entries per page
    @page integer the current page
    @total_count integer total number of all entries
    @pages_count integer total number of pages

    Chargeback types

    Chargebacks will have one of the following type:

    Status Description
    1st Chargeback The first stage of the dispute procedure raised by the issuer
    2nd Chargeback Second stage of the dispute procedure raised by the issuer (MasterCard only)
    1st Chargeback Reversal When the first chargeback is cancelled (withdrawn) by the issuer
    2nd Chargeback Reversal When the second chargeback is cancelled (withdrawn) by the issuer (MasterCard only)
    Transfer Reversal An operation that sends the amount of the dispute to the merchant when the acquirer represents a chargeback
    Re-presentment Acquirer’s defend of the issuer’s (first) chargeback
    Chargeback Transfer to Merchant Hold Acc The money is taken from merchant’s hold account in Omnipay and is sent to the issuer
    Chargeback Transfer to Writeoff Account Acq The acquirer is taking the loss for this chargeback
    Chargeback Transfer to Paymnt Acct Retail The money is taken from merchant’s account in Omnipay and are sent to the issuer (as per the chargeback rules).
    Chargeback Transfer to Writeoff SP The Service Provider is taking the loss for the chargeback.

    Retrieval Requests

    Retrieval requests are a special type of transactions as they cannot be triggered by the merchant. Retrieval requests occur if the issuer requests additional documentation for a transaction. Retrieval requests do not have financial implication, but they indicate the issuer doubts a given transaction and can initiate a chargeback.

    For details, please contact our Risk team.

    You can see also see a retrieval request overview in the merchant console under the Risk Management menu.

    Retrieval Request notifications

    You now have the option to receive API and/or email notifications for each retrieval request event. Enable this feature by emailing the IT Support team at tech-support@e-comprocessing.com with the desired notification URL.

    The email notifications are sent to the merchant user with role ’admin’ which is configured for managing the merchant entity on the gateway platform. The API notifications are equal to Notification for asynchronous payments, please refer to the section Notification for asynchronous payments to understand how notifications work.

    Retrieval Notification Example

    ?transaction_id=30450
&terminal_token=cd577214de104fa0dd9c28486b3c817fd08c89a6
&unique_id=5de39380bf7ac7e1fc31cbd7805dc0ec
&transaction_type=sale
&status=chargebacked
&signature=98676c91391094b823d1f521d06cc129195952f9
&amount=400
&currency=USD
&avs_response_code=5I
&avs_response_text=Response+provided+by+issuer+processor%3B+Address+information+not+verified
&reason_code=10
&reason_description=Dispute+Transaction
&post_date=2014-07-16
&arn=17b4646c093b025
&event=retrieval_request

    Retrieval Request API

    The retrieval request API can be used to get info for retrieval requests.

    Single Retrieval Request

    Single retrieval request retrieval allows to get a certain retrieval request by its ARN or by passing the unique ID of the original transaction.

    <?xml version="1.0" encoding="UTF-8"?>
<retrieval_request_request>
  <arn>74537604221431003881865</arn>
</retrieval_request_request>

    OR

    <?xml version="1.0" encoding="UTF-8"?>
<retrieval_request_request>
  <original_transaction_unique_id>53b1f5eacc9e4d3a3afebb4e993fe962</original_transaction_unique_id>
</retrieval_request_request>

    The URLs for the single retrieval request API are:

    Production: https://gate.e-comprocessing.net/retrieval_equests

    Staging (for integration) https://staging.gate.e-comprocessing.net/retrieval_requests










    <?xml version="1.0" encoding="UTF-8"?>
<retrieval_request_response>
  <type>Retrieval request</type>
  <arn>74537604221431003881865</arn>
  <post_date>2014-01-24</post_date>
  <reason_code>42</reason_code>
  <reason_description>Potential Chargeback</reason_description>
  <authorization_code>811714</authorization_code>
  <card_number>554960******5069</card_number>
  <card_brand>master</card_brand>
  <customer_email>jonh_doe@example.com</customer_email>
  <customer_phone>3598851248512</customer_phone>
  <transaction_type>sale3d</customer_phone>
  <original_transaction_unique_id>f9634ec5e7dbe6ca3871974accb875cd</original_transaction_unique_id>
</retrieval_request_response>

    Response parameters:

    Name Type Description
    type string The chargeback type. See chargeback types for details
    arn string ARN of the chargeback’s transaction
    post_date string The date of the chargeback
    reason_code string Reason code of the chargeback
    reason_description string Reason description of the chargeback
    authorization_code string Authorization code of the chargeback’s transac- tion
    card_number string Card number used for the chargeback’s transaction
    card_brand string Card brand of the card number
    customer_email string The email of the cardholder
    customer_phone integer The phone of the cardholder
    transaction_type string The type of the chargeback’s transaction
    original_transaction_unique_id string The unique id of the chargeback’s transaction 
    <?xml version="1.0" encoding="UTF-8"?>
<retrieval_request_response>
  <technical_message>Retrieval request by the given criteria cannot be found!</technical_message>
  <status>error</status>
  <message>Retrieval request not found!</message>
  <code>480</code>
</retrieval_request_response>

    In case no retrieval request is found with the given ARN or unique ID, a corresponding XML response is as follows:

    By date range

    Date range based retrieval request retrieval allows you to fetch information for all retrieval requests for a given merchant within a given date range. Date range searches for chargebacks by their posting date. The response is paginated, each request will return 100 entries max.

    The URLs for date range retrieval request retrieval are:

    Production: https://gate.e-comprocessing.net/retrieval_requests/by_date

    Staging (for integration): https://staging.gate.e-comprocessing.net/retrieval_requests/by_date

    Request parameters:

    <?xml version="1.0" encoding="UTF-8"?>
<chargeback_request>
  <start_date>2014-01-01</start_date>
  <end_date>2014-01-31</end_date>
  <page>2</page>
</chargeback_request>
    Parameter Required Format Description
    start_date required yyyy-mm-dd start of the requested date range
    end_date optional yyyy-mm-dd end of the requested date range
    page optional integer the page within the paginated result, defaults to 1

    Response parameters:

    The attributes in the root node retrieval_request_responses includes information about the pagination of the response.

    <?xml version="1.0" encoding="UTF-8"?>
<retrieval_request_responses per_page="100" page="2" total_count="19" pages_count="7">
  <retrieval_request_response>
    <type>Retrieval request</type>
    <arn>74537604221431003881865</arn>
    <post_date>2014-01-24</post_date>
    <reason_code>42</reason_code>
    <reason_description>Potential Chargeback</reason_description>
    <authorization_code>811714</authorization_code>
    <card_number>554960******5069</card_number>
    <card_brand>master</card_brand>
    <customer_email>emil@e-comprocessing.net</customer_email>
    <customer_phone>3598851248512</customer_phone>
    <transaction_type>sale3d</transaction_type>
    <original_transaction_unique_id>f9634ec5e7dbe6ca3871974accb875cd</original_transaction_unique_id>
  </retrieval_request_response>
  <retrieval_request_response>
    <type>Retrieval request</type>
    <arn>74537604221431003881862</arn>
    <post_date>2014-01-27</post_date>
    <reason_code>42</reason_code>
    <reason_description>Potential Chargeback</reason_description>
    <authorization_code>123456</authorization_code>
    <card_number>454360******5008</card_number>
    <card_brand>visa</card_brand>
    <customer_email>ivan@e-comprocessing.net</customer_email>
    <customer_phone>3598851248123</customer_phone>
    <transaction_type>sale</transaction_type>
    <original_transaction_unique_id>67fbebc172b743a164a3f3af3d010457</original_transaction_unique_id>
  </retrieval_request_response>
  ...
</retrieval_request_responses>
    Name Type Description
    @per_page integer number of entries per page
    @page integer the current page
    @total_count integer total number of all entries
    @pages_count integer total number of pages

    Fraud reports

    SAFE/TC40 reports contain information for transactions reported as fraud to MasterCard or VISA.

    You can see a SAFE/TC40 reports overview in the merchant console under the Risk management menu.

    SAFE/TC40 API

    The SAFE/TC40 API can be used to retrieve data about SAFE/TC40 reports.

    Single SAFE/TC40 report

    Single SAFE/TC40 retrieval allows to get a certain SAFE/TC40 by its ARN or by passing the unique ID of the original transaction.

    <?xml version="1.0" encoding="UTF-8"?>
<fraud_report_request>
  <arn>74537604221431003881865</arn>
</fraud_report_request>

    OR

    <?xml version="1.0" encoding="UTF-8"?>
<fraud_report_request>
  <original_transaction_unique_id>53b1f5eacc9e4d3a3afebb4e993fe962</original_transaction_unique_id>
</fraud_report_request>

    The URLs for the single SAFE/TC40 API are:

    Production: https://gate.e-comprocessing.net/fraud_reports

    Staging (for integration): https://staging.gate.e-comprocessing.net/fraud_reports










    <?xml version="1.0" encoding="UTF-8"?>
<fraud_report_response>
  <arn>74537604221431003881865</arn>
  <transaction_date>2014-01-24</transaction_date>
  <fraud_type_code>6</fraud_type_code>
  <amount>400</amount>
  <currency>GBP</currency>
  <card_number>554960******5069</card_number>
  <card_brand>master</card_brand>
  <customer_email>jonh_doe@example.com</customer_email>
  <customer_phone>3598851248512</customer_phone>
  <transaction_type>sale3d</customer_phone>
  <original_transaction_unique_id>f9634ec5e7dbe6ca3871974accb875cd</original_transaction_unique_id>
  <original_merchant_transaction_id>123294sss</original_merchant_transaction_id>
</fraud_report_response>

    Response parameters:

    Name Type Description
    arn string ARN of the chargeback’s transaction
    transaction_date yyyy-mm-dd The date transaction is made
    amount float Amount in the cardholder account currency. Amount can be negative for: 1st chargeback, 2nd chargeback, transfer reversal and positive for all other types.
    currency string(3) Currency of the cardholder account. See ISO 4217
    card_number string Card number used for the chargeback’s transaction
    card_brand string Card brand of the card number
    customer_email string The email of the cardholder
    customer_phone integer The phone of the cardholder
    transaction_type string The type of the chargeback’s transaction
    original_transaction_unique_id string The unique id of the chargeback’s transaction 
    <?xml version="1.0" encoding="UTF-8"?>
<fraud_report_response>
  <technical_message>Mastercard fraud report by the given criteria cannot be found!</technical_message>
  <status>error</status>
  <message>Mastercard Fraud Report not found!</message>
  <code>490</code>
</fraud_report_response>

    In case no SAFE/TC40 is found for the given ARN or unique ID, a corresponding XML response is as follows:

    By date range

    Date range based SAFE/TC40 retrieval allows you to fetch information for all SAFE/TC40 reports for a given merchant within a given date range. Date range searches for SAFE/TC40 reports by their posting date. Search option is SAFE/TC40 retrieval by their import (creation) date. The response is paginated, each request will return 100 entries max.

    The URLs for date range SAFE/TC40 retrieval are:

    Production: https://gate.e-comprocessing.net/fraud_reports/by_date

    Staging (for integration): https://staging.gate.e-comprocessing.net/fraud_reports/by_date

    Request parameters:

    <?xml version="1.0" encoding="UTF-8"?>
<fraud_report_request>
  <start_date>2014-01-01</start_date>
  <end_date>2014-01-31</end_date>
  <page>2</page>
</fraud_report_request>
    Parameter Required Format Description
    start_date required yyyy-mm-dd start of the requested date range
    end_date optional yyyy-mm-dd end of the requested date range
    page optional integer the page within the paginated result, defaults to 1

    Response parameters:

    The attributes in the root node mastercard fraud report responses includes information about the pagination of the response.

    <?xml version="1.0" encoding="UTF-8"?>
<fraud_report_responses per_page="100" page="2" total_count="19" pages_count="7">
  <fraud_report_response>
    <arn>74537604221431003881865</arn>
    <transaction_date>2014-01-24</transaction_date>
    <fraud_type_code>6</fraud_type_code>
    <amount>14625</amount>
    <currency>USD</currency>
    <card_number>554960******5069</card_number>
    <card_brand>master</card_brand>
    <customer_email>jonh_doe@examle.com</customer_email>
    <customer_phone>3598851248512</customer_phone>
    <transaction_type>sale3d</transaction_type>
    <original_transaction_unique_id>f9634ec5e7dbe6ca3871974accb875cd</original_transaction_unique_id>
    <original_merchant_transaction_id>f9634ec5e7d5cd</original_merchant_transaction_id>
  </fraud_report_response>
  <fraud_report_response>
    <arn>74537604221431003881862</arn>
    <transaction_date>2014-01-27</transaction_date>
    <fraud_type_code>4</fraud_type_code>
    <amount>3456</amount>
    <currency>EUR</currency>
    <card_number>454360******5008</card_number>
    <card_brand>visa</card_brand>
    <customer_email>jenny_doe@example.com</customer_email>
    <customer_phone>3598851248123</customer_phone>
    <transaction_type>sale</transaction_type>
    <original_transaction_unique_id>67fbebc172b743a164a3f3af3d010457</original_transaction_unique_id>
    <original_merchant_transaction_id>67fbebc172b743a164a3f3af3d010457</original_merchant_transaction_id>
  </fraud_report_response>
...
</fraud_report_responses>
    Name Type Description
    @per_page integer number of entries per page
    @page integer the current page
    @total_count integer total number of all entries
    @pages_count integer total number of pages

    Blacklists

    With the Blacklist API you can check if a certain credit card is blacklisted within the gateway. If a terminal token is not passed, the merchant and global PAN blacklists will be checked for the given card number. If a terminal token is passed, the terminal, its merchant, and the global PAN blacklists will be checked for blacklist matches.

    The URLs for the Blacklist API are:

    Production: https://gate.e-comprocessing.net/blacklists

    Staging (for integration): https://staging.gate.e-comprocessing.net/blacklists

    Invoking a Request

    A transaction is invoked via HTTPS POST, parameters are passed as XML with UTF-8 encoding.

    <?xml version="1.0" encoding="UTF-8"?>
<blacklist_request>
  <card_number>4200000000000000</card_number>
  <terminal_token>abd30ed00f88f838c5d233cbb62b6da0b69267b4</terminal_token>
</blacklist_request>
    Parameter Required Format Description
    card_number required int(13..16) the credit card number to be checked
    terminal_token optional string(40) the terminal token

    Response

    Successful response:

    <?xml version="1.0" encoding="UTF-8"?>
<blacklist_response>
  <blacklisted>true</blacklisted>
</blacklist_response>
    Name Type Description
    blacklisted boolean credit card number is blacklisted or not

    Error response:

    <?xml version="1.0" encoding="UTF-8"?>
<blacklist_response>
  <code>350</code>
  <message>Invalid XML: No close tag for /blacklist_request</message>
</blacklist_response>
    Name Type Description
    code integer error code of the error that occurred
    message string info about the error

    Asynchronous Transactions and Notifications

    Asynchronous Transactions

    3-D secure transactions are always processed asynchronously, while the other transactions are processed synchronously.

    This means that the final result of the transaction will not be available immediately and the status is pending async. Once the transaction has reached a final status, a Notification is sent to the merchant.

    Overview

    Transaction type async?
    Authorize never
    Authorize3d always
    Sale never
    Sale3d always
    Capture never
    Refund never
    Void never
    InitRecurringSale never
    InitRecurringSale3D always
    RecurringSale never
    Credit never
    BitPay Sale always
    BitPay Refund always

    Notifications

    For asynchronous payments a notification is always sent to the notification_url within the payment transaction.

    The payment gateway can be configured to also send a notification after each synchronous payment transaction. The notification is sent to the notification_url which is configured per merchant.

    Also see 3-D Secure Transactions and Notification for asynchronous payments.

    The format of the notification in both cases is the same.

    Notification Example

    ?transaction_id=82803B4C-70CC-43BD-8B21-FD0395285B40
&unique_id=44177a21403427eb96664a6d7e5d5d48
&transaction_type=sale3d
&terminal_token=394f2ebc3646d3c017fa1e1cbc4a1e20
&status=approved
&amount=500
&signature=088e16a1019277b15d58faf0541e11910eb756f6
&consumer_id=123456
&token=ee946db8-d7db-4bb7-b608-b65b153e127d
&eci=05
&avs_response_code=5I
&avs_response_text=Response+provided+by+issuer+processor%3B+Address+information+not+verified

    Parameters

    Name Type Description
    transaction_id string merchant generated transaction id
    unique_id string unique id generated by Genesis
    transaction_type string transaction type for the transaction eg: sale3d
    terminal_token string the terminal token as used in the processing url
    status string status of the payment transaction
    amount string amount of the payment transaction. If the transaction is partially approved, this is the partially approved amount. Check Partial Approvals for details
    partial_approval string If the transaction is partially approved, this is set to 'true'. Check Partial Approvals for details
    signature string the signature of the notification, should be used to verify the notification was sent by Genesis
    consumer_id string(10) Consumer unique reference. See Consumers
    token string(36) Plain-text token value. See Tokenize
    eci string See Electronic Commerce Indicator as returned from the MPI for details
    event string The event that caused the notification
    rc_code string The reason code for the event
    rc_description string The reason description for the event
    avs_response_code string Generated by the card network on trying to match the billing ad- dress when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.

    Status will be either "declined", "approved" or "error", like shown in the states table.

    The event parameter is added only for fraud transactions eg: chargeback, chargeback_reversal, representment, second_chargeback or retrieval_request.

    The signature is a mean of security to ensure that the gate is really the sender of the notification. It is generated by concatenating the unique id of the transaction with your API password and generating a SHA1 Hash (Hex) of the string:

    SHA1 Hash Hex of <unique_id><Your API password>

    Notification signature examples

    unique_id API password signature
    fc6c3c8c0219730c7a099eaa540f70dc bogus 08d01ae1ebdc22b6a1a764257819bb26e9e94e8d
    130319cfb3bf65ff3c4a4045487b173e test123 1b34dabed996788efcc049567809484454ee8b17

    You can use the signature to verify the integrity of the notification, ensuring that it was really sent by the gate.

        <?xml version="1.0" encoding="UTF-8"?>
    <notification_echo>
        <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    </notification_echo>

    When receiving the notification, you are required to render an xml page containing the transaction’s unique id so that the gateway knows that you have accepted the notification. If the XML is not delivered, the notification is sent periodically until the XML is received.

    WPF

    The WPF (Web Payment Form) is a customizable component of the Genesis payment gateway. It provides merchants with an intuitive user interface to easily process their customers’ payments. Through a single point of integration, the merchant can offer his customers multiple payment methods instantly and since the WPF is hosted on the secure Genesis infrastructure, it is already PCI-DSS compliant.

    Workflow

    WPF workflow diagram

    In the example above the customer visits the merchant’s website and does a checkout.

    (1), the merchant initiates the payment on the Genesis payment gateway through a request to the WPF API, which carries the mandatory, initial payload (e.g. amount, currency, etc.). The response to this request (if successful) is a redirect URL, which the merchants hands over to the customer. Following this redirect URL

    (2), the customer is then directed to the actual payment form (WPF), which gets served from the Genesis servers. Because the merchant has previously transmitted most of the relevant payment information, the form is prefilled with these values and the customer only needs to add personal data. The customer then selects one of the payment methods offered by the merchant and fills in his payment information

    (3) (e.g. credit card data). Upon completion the customer is redirected back to the merchant

    (4)1. After the payment has been processed and reached a final state the merchant is sent a notification

    (5) to the notification url supplied in the initial create request (1). The merchant must either use the notification’s signature to verify the payment’s integrity or make a reconcile

    (6) to check the final payment status. However, we urge all merchants to always do a reconcile.

    1 - Particularly to the return success url defined by the merchant in his initial request. If the customer has selected an asynchronous payment method, he is redirected to the MPI provider before this step

    WPF API

    URLs

    Create:

    The URL for the WPF API create method is:

    https://wpf.e-comprocessing.net/<locale>/wpf

    For the test system the URL is:

    https://staging.wpf.e-comprocessing.net/<locale>/wpf

    Note that if you do not submit one of the available locales, defaults to 'en' (English).

    Check the WPF Internationalization (i18n) for details.

    Reconcile:

    The URL for the WPF API reconcile method is:

    https://wpf.e-comprocessing.net/wpf/reconcile

    For the test system the URL is:

    https://staging.wpf.e-comprocessing.net/wpf/reconcile

    Create

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('WPF\Create');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setDescription('You are about to buy 3 shoes at www.shoes.com!')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setReturnCancelUrl('http://www.example.com/cancel.html')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setConsumerId('123456')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')
  ->setRememberCard('true')
  ->setLifetime('60')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // Risk Params
  ->setRiskUserId('123456')


  // Transaction Types
  ->addTransactionType('authorize')
  ->addTransactionType('sale')
  ->setPayLater('true')


  // Reminders
  ->addReminder('email', '40')
  ->addReminder('sms', '10')


  ->setFxRateId('123');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.wpf.WPFCreateRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    WPFCreateRequest request = new WPFCreateRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setDescription("You are about to buy 3 shoes at www.shoes.com!");
    request.setNotificationUrl(new URL("https://www.example.com/notification"));
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setReturnCancelUrl(new URL("http://www.example.com/cancel.html"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setConsumerId("123456");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");
    request.setRememberCard("true");
    request.setLifetime(60);


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Risk Params
    request.setRiskUserId("123456");


    // Transaction Types
    request.addTransactionType("authorize").done();
    request.addTransactionType("sale").done();
    request.setPayLater("true");
    request.setFxRateId("123");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.wpf_create(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "description": "You are about to buy 3 shoes at www.shoes.com!",
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "return_cancel_url": "http://www.example.com/cancel.html",
    "amount": "100",
    "currency": "USD",
    "consumer_id": "123456",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "remember_card": "true",
    "lifetime": 60,
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "risk_params": {
      "user_id": "123456"
    },
    "transaction_types": [
      "authorize",
      "sale"
    ],
    "business_attributes": {
      "name_of_the_supplier": "Best Furniture"
    },
    "pay_later": true,
    "reminder_language": "en",
    "reminders": [
      {
        "channel": "email",
        "after": 40
      },
      {
        "channel": "sms",
        "after": 10
      }
    ],
    "fx_rate_id": 123
  }
).send()
  .then(success)
  .catch(failure);

    curl https://staging.wpf.e-comprocessing.net/wpf \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <wpf_payment>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <description>You are about to buy 3 shoes at www.shoes.com!</description>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <return_cancel_url>http://www.example.com/cancel.html</return_cancel_url>
    <amount>100</amount>
    <currency>USD</currency>
    <consumer_id>123456</consumer_id>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <remember_card>true</remember_card>
    <lifetime>60</lifetime>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
    <transaction_types>
      <transaction_type moto="true" name="authorize"/>
      <transaction_type gaming="true" name="sale">
        <crypto>true</crypto>
      </transaction_type>
    </transaction_types>
    <business_attributes>
      <name_of_the_supplier>Best Furniture</name_of_the_supplier>
    </business_attributes>
    <pay_later>true</pay_later>
    <reminder_language>en</reminder_language>
    <reminders>
      <reminder>
        <channel>email</channel>
        <after>40</after>
      </reminder>
      <reminder>
        <channel>sms</channel>
        <after>10</after>
      </reminder>
    </reminders>
    <fx_rate_id>123</fx_rate_id>
  </wpf_payment>'

    Request Parameters

    Parameter Required Format Description
    transaction_id required string(255) Unique transaction id defined by merchant
    usage optional string(255) Description of the transaction for later use
    amount required* integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency required* string(3) Currency code in ISO 4217
    description optional string a text describing the reason of the payment (e.g. "you’re buying concert tickets")
    consumer_id required* string(10) See Consumers and Tokenization. Saved cards will be listed for user to select
    customer_email required* e-mail address Must contain valid e-mail of customer
    customer_phone required* string(32) Must contain valid phone number of customer
    notification_url required url URL at merchant where gateway sends outcome of transaction.
    return_success_url required url URL where customer is sent to after successful payment
    return_failure_url required url URL where customer is sent to after unsuccessful payment
    return_cancel_url required string URL where customer is sent to when the customer cancels the payment process within the WPF
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required* string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    transaction_types required The transaction types that the merchant is willing to accept payments for
       transaction_type required string One of the available WPF transaction types. Multiple transaction type elements supported. Attribute ’name’ contains the transaction type name in question
    business_attributes required* Check business attributes section.
       event_start_date required* dd-mm-yyyy The date when event starts in format dd-mm-yyyy
       event_end_date required* dd-mm-yyyy The date when event ends in format dd-mm-yyyy
       event_organizer_id required* string
       event_id required* string
       date_of_order required* dd-mm-yyyy The date when order was placed in format dd-mm-yyyy
       delivery_date required* dd-mm-yyyy Date of the expected delivery in format dd-mm-yyyy
       name_of_the_supplier required* string
    remember_card optional "true" See Tokenize. Offer the user the option to save cardholder details for future use (tokenize).
    lifetime optional integer number of minutes determining how long the WPF will be valid. Will be set to 30 minutes by default. Valid value ranges between 1 minute and 31 days given in minutes
    risk_params optional list of risk params as described in the Advanced risk management with RiskParams section
       user_id (example) optional string the customer’s ID within the merchant’s system (example)
       session_id (example) optional string the customer’s session ID within the mer- chant’s system (example)
    dynamic_descriptor_params optional
       merchant_name optional string(25) Allows to dynamically override the charge descriptor
       merchant_city optional string(13) Allows to dynamically override the merchant phone number
    pay_later optional "true" Signifies whether the ’Pay Later’ feature would be enabled on the WPF
    reminder_language optional string It must be a valid language abbreviation from the available WPF languages
    reminders optional Settings for reminders sending when using the ’Pay Later’ feature. The number of the sent reminders would be exactly as sent or configured and delivery failures could be handled on demand. Also there will be no reminders sent if the WPF is already completed
       reminder optional Settings for a single reminder. Upto three reminders are allowed
          channel optional string Channel for sending WPF reminder. Valid values are ’email’ and ’sms’
          after optional integer Number of minutes after WPF creation when the reminder should be sent. Valid value ranges between 1 minute and 31 days given in minutes
    crypto optional "true" Signifies whether a purchase of cryptocurrency transaction is performed. Must be populated when purchasing cryptocurrency with a VISA card and MCC 6051. In this case, the gaming flag must be sent too. Contact tech-support@e-comprocessing.com for more details.
    gaming optional "true" Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech support for more details.
    moto optional "true" Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech support for more details.
    fx_rate_id optional integer See Get rates for FX Service. Offers the option to use a specific FX rate to convert the transaction processing amount. Used FX rate should have the same source currency as the processing currency. Contact tech-support@e-comprocessing.com for more details.

    required* = conditionally required

    Successful Response

    stdClass Object
(
    [transaction_type] => wpf_create
    [status] => new
    [mode] => live
    [transaction_id] => 43671
    [consumer_id] => 123456
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [technical_message] => Transaction successful!
    [message] => Transaction successful!
    [redirect_url] => https://staging.wpf.e-comprocessing.net/en/payment/c7e32c1e9d1
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:10.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [amount] => 100
    [currency] => USD
)

    <payment_response content=[
    <transaction_type content=[wpf_create]>
    <status content=[new]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <consumer_id content=[123456]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <technical_message content=[Transaction successful!]>
    <message content=[Transaction successful!]>
    <redirect_url content=[https://staging.wpf.e-comprocessing.net/en/payment/c7e32c1e9d1]>
    <timestamp content=[2019-09-17T15:39:10Z]>
    <amount content=[100]>
    <currency content=[USD]>
]>

    {
    transaction_type: "wpf_create",
    status: "new",
    mode: "live",
    transaction_id: "43671",
    consumer_id: "123456",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    technical_message: "Transaction successful!",
    message: "Transaction successful!",
    redirect_url: "https://staging.wpf.e-comprocessing.net/en/payment/c7e32c1e9d1",
    timestamp: "2019-09-17T15:39:10Z",
    amount: "100",
    currency: "USD",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <wpf_payment>
    <transaction_type>wpf_create</transaction_type>
    <status>new</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <consumer_id>123456</consumer_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <technical_message>Transaction successful!</technical_message>
    <message>Transaction successful!</message>
    <redirect_url>https://staging.wpf.e-comprocessing.net/en/payment/c7e32c1e9d1</redirect_url>
    <timestamp>2019-09-17T15:39:10Z</timestamp>
    <amount>100</amount>
    <currency>USD</currency>
  </wpf_payment>

    Successful With Optional Invalid Transactions For Amount Response

    stdClass Object
(
    [consumer_id] => 123456
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:10.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [amount] => 100
    [currency] => USD
    [redirect_url] => https://staging.wpf.e-comprocessing.net/en/payment/c7e32c1e9d1
    [invalid_transactions_for_amount] => alipay
)

    <payment_response content=[
    <consumer_id content=[123456]>
    <timestamp content=[2019-09-17T15:39:10Z]>
    <amount content=[100]>
    <currency content=[USD]>
    <redirect_url content=[https://staging.wpf.e-comprocessing.net/en/payment/c7e32c1e9d1]>
    <invalid_transactions_for_amount content=[alipay]>
]>

    {
    consumer_id: "123456",
    timestamp: "2019-09-17T15:39:10Z",
    amount: "100",
    currency: "USD",
    redirect_url: "https://staging.wpf.e-comprocessing.net/en/payment/c7e32c1e9d1",
    invalid_transactions_for_amount: "alipay",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <wpf_payment>
    <consumer_id>123456</consumer_id>
    <timestamp>2019-09-17T15:39:10Z</timestamp>
    <amount>100</amount>
    <currency>USD</currency>
    <redirect_url>https://staging.wpf.e-comprocessing.net/en/payment/c7e32c1e9d1</redirect_url>
    <invalid_transactions_for_amount>alipay</invalid_transactions_for_amount>
  </wpf_payment>

    Successful Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    consumer_id string(10) Consumer unique reference. See Consumers
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.
    redirect_url url URL where user has to be redirected to complete payment process. Contains the locale in which the web payment form will be rendered by default. See WPF Internationalization (i18n)
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217
    invalid_transactions_for_amount string* list of comma separated transactions for which amount is not within the allowed limit *present only when at least for one transaction type an amount is invalid, check Currency and Amount Handling for details

    Error Response

    stdClass Object
(
    [transaction_type] => wpf_create
    [status] => error
    [mode] => live
    [transaction_id] => 43671
    [unique_id] => 44177a21403427eb96664a6d7e5d5d48
    [code] => 330
    [technical_message] => Unknown system error. Please contact support.
    [message] => Transaction failed, please contact support!
    [timestamp] => DateTime Object
        (
            [date] => 2019-09-17 15:39:10.000000
            [timezone_type] => 2
            [timezone] => Z
        )
    [amount] => 100
    [currency] => USD
)

    <payment_response content=[
    <transaction_type content=[wpf_create]>
    <status content=[error]>
    <mode content=[live]>
    <transaction_id content=[43671]>
    <unique_id content=[44177a21403427eb96664a6d7e5d5d48]>
    <code content=[330]>
    <technical_message content=[Unknown system error. Please contact support.]>
    <message content=[Transaction failed, please contact support!]>
    <timestamp content=[2019-09-17T15:39:10Z]>
    <amount content=[100]>
    <currency content=[USD]>
]>

    {
    transaction_type: "wpf_create",
    status: "error",
    mode: "live",
    transaction_id: "43671",
    unique_id: "44177a21403427eb96664a6d7e5d5d48",
    code: "330",
    technical_message: "Unknown system error. Please contact support.",
    message: "Transaction failed, please contact support!",
    timestamp: "2019-09-17T15:39:10Z",
    amount: "100",
    currency: "USD",
}

      <?xml version="1.0" encoding="UTF-8"?>
  <wpf_payment>
    <transaction_type>wpf_create</transaction_type>
    <status>error</status>
    <mode>live</mode>
    <transaction_id>43671</transaction_id>
    <unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
    <code>330</code>
    <technical_message>Unknown system error. Please contact support.</technical_message>
    <message>Transaction failed, please contact support!</message>
    <timestamp>2019-09-17T15:39:10Z</timestamp>
    <amount>100</amount>
    <currency>USD</currency>
  </wpf_payment>

    Error Response Parameters

    Parameter Type Description
    transaction_type string The transaction type
    status string Status of the transaction, see states
    mode string Mode of the transaction’s terminal, can be "live" or "test"
    transaction_id string(255) Unique transaction id defined by merchant
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Notification

    WPF Notifications are sent once the WPF payment has reached a final state and are transmitted via HTTP POST (application/x-www-form-urlencoded) with the following parameters:

    signature=c5219b3d385e74496b2b48a5497b347e102849f10eacd25b062f823b
&payment_transaction_transaction_type=sale
&payment_transaction_terminal_token=e9fd7a957845450fb7ab9dccb498b6e1f6e1e3aa
&payment_transaction_unique_id=bad08183a9ec545daf0f24c48361aa10
&payment_transaction_amount=500
&wpf_transaction_id=mtid201104081447161135536962
&wpf_status=approved
&wpf_unique_id=26aa150ee68b1b2d6758a0e6c44fce4c
&consumer_id=123456
&payment_transaction_token=ee946db8-d7db-4bb7-b608-b65b153e127d
&notification_type=wpf
&eci=05
&payment_transaction_avs_response_code=5I
&payment_transaction_avs_response_text=Response+provided+by+issuer+processor%3B+Address+information+not+verified
    Name Type Description
    signature string the signature of the notification, should be used to verify the the notification was sent by Genesis
    payment_transaction_transaction_type string transaction type for the transaction eg: sale3d
    payment_transaction_terminal_token string the terminal token as used in the processing url
    payment_transaction_unique_id string unique id generated by Genesis
    payment_transaction_amount string Amount of the payment transaction. If the transaction is partially approved, this is the partially approved amount. Check Partial Approvals for details
    payment_transaction_partial_approval string If the transaction is partially approved, this is set to ’true’. Check Partial Approvals for details
    wpf_transaction_id string merchant generated tranaction id
    wpf_status string status of the payment transaction
    wpf_unique_id string unique id generated by Genesis, required for WPF payment reconciliation
    consumer_id string(10) Consumer unique reference. See Consumers
    payment_transaction_token string(36) Plain-text token value. See Tokenize
    notification_type string constant value "wpf"
    eci string See Electronic Commerce Indicator as returned from the MPI for details
    payment_transaction_avs_response_code string Generated by the card network on trying to match the billing address when performing the address verification. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.
    payment_transaction_avs_response_text string Gives the human response text for the AVS response code above. Optional, returned if config is enabled and acquirer supports it. Check AVS Status Codes for details.

    Status will be one of the following: approved, declined, error, timeout, pending, refunded, voided, chargebacked, chargeback reversed, represented and second chargebacked.

    The signature is a mean of security to ensure that the gate is really the sender of the notification. It is generated by concatenating the unique id of the payment with your API password and generating a SHA-512 Hash (Hex) of the string:

    SHA-512 Hash Hex of <wpf_unique_id><Your Merchant API password>

    Notification signature examples

    unique id API password signature
    26aa150ee68b1b2d6758a0e6c44fce4c 50fd87e65eb415f42fb5af4c9cf497662e00b785 c5219b3d385e74496b2b48a549
    3f760162ef57a829011e5e2379b3fa17 50fd87e65eb415f42fb5af4c9cf497662e00b785 14519d0db2f7f8f407efccc9b099 
    <?xml version="1.0" encoding="UTF-8"?>
<notification_echo>
  <wpf_unique_id>3f760162ef57a829011e5e2379b3fa17</wpf_unique_id>
</notification_echo>

    When receiving the notification, you are required to render an xml page containing the transaction’s unique id so that the gateway knows that you have accepted the notification. If the XML is not delivered, the notification is sent periodically until the XML is received.

    Reconcile

    Reconcile can be used to retrieve data about a payment. This can be useful if you want to retrieve information about a payment whose status is timeout, which returned an error or has changed eg. has beed chargebacked.

    Reconcile requests are handled exactly like transaction requests via XML. To a large degree, the WPF Reconcile follows the notions of the standard processing Reconcile API.

    <?xml version="1.0" encoding="UTF-8"?>
<wpf_reconcile>
  <unique_id>26aa150ee68b1b2d6758a0e6c44fce4c</unique_id>
</wpf_reconcile>
    Parameter Required Format Description
    unique_id required string(32) unique id as returned by the create request

    Example Reconcile Response XML for successful payment that is partially approved (check Partial Approvals for details):

    <?xml version="1.0" encoding="UTF-8"?>
<wpf_payment>
  <status>approved</status>
  <unique_id>26aa150ee68b1b2d6758a0e6c44fce4c</unique_id>
  <transaction_id>mtid201104081447161135536962</transaction_id>
  <consumer_id>123456</consumer_id>
  <timestamp>2011-04-08T14:46:27Z</timestamp>
  <amount>5000</amount>
  <currency>USD</currency>
  <usage>Shopify Electronic Transaction</usage>
  <description>You are about to buy shoes from Shopify</description>
  <card_brand>visa</card_brand>
  <card_number>420000...0000</card_number>
  <card_holder>John Doe</card_holder>
  <expiration_year>2020</expiration_year>
  <expiration_month>2</expiration_month>
  <payment_transaction>
    <status>approved</status>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <transaction_type>sale</transaction_type>
    <unique_id>bad08183a9ec545daf0f24c48361aa10</unique_id>
    <transaction_id>mtid201104081447161135536962</transaction_id>
    <arn>74537605259536043849425</arn>
    <terminal_token>e9fd7a957845450fb7ab9dccb498b6e1f6e1e3aa</terminal_token>
    <mode>test</mode>
    <timestamp>2011-04-08T14:46:40Z</timestamp>
    <descriptor>e-comprocessing.net/bogus +49123456789</descriptor>
    <amount>4900</amount>
    <partial_approval>true</partial_approval>
    <currency>USD</currency>
    <customer_email>john.doe@example.com</customer_email>
    <customer_phone>+11234567890</customer_phone>
    <technical_message>TESTMODE: No real money will be transferred!</technical_message>
    <message>TESTMODE: No real money will be transferred!</message>
    <billing_address>
      <first_name>John</first_name>
      <last_name>Doe</last_name>
      <address1>32, Doestreet</address1>
      <address2></address2>
      <zip_code>12345</zip_code>
      <city>New York</city>
      <state>NY</state>
      <country>US</country>
    </billing_address>
  </payment_transaction>
</wpf_payment>

    Example Response XML for voided payment:

    <?xml version="1.0" encoding="UTF-8"?>
<wpf_payment>
  <status>voided</status>
  <unique_id>26aa150ee68b1b2d6758a0e6c44fce4c</unique_id>
  <transaction_id>mtid201104081447161135536962</transaction_id>
  <consumer_id>123456</consumer_id>
  <timestamp>2011-04-08T14:46:27Z</timestamp>
  <amount>5000</amount>
  <currency>USD</currency>
  <usage>Shopify Electronic Transaction</usage>
  <description>You are about to buy shoes from Shopify</description>
  <card_brand>visa</card_brand>
  <card_number>420000...0000</card_number>
  <card_holder>John Doe</card_holder>
  <expiration_year>2020</expiration_year>
  <expiration_month>2</expiration_month>
  <payment_transaction>
    <status>voided</status>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <transaction_type>sale</transaction_type>
    <unique_id>bad08183a9ec545daf0f24c48361aa10</unique_id>
    <transaction_id>mtid201104081447161135536962</transaction_id>
    <arn>74537605259536043849425</arn>
    <terminal_token>e9fd7a957845450fb7ab9dccb498b6e1f6e1e3aa</terminal_token>
    <mode>test</mode>
    <timestamp>2011-04-08T14:46:40Z</timestamp>
    <descriptor>e-comprocessing.net/bogus +49123456789</descriptor>
    <amount>5000</amount>
    <currency>USD</currency>
    <customer_email>john.doe@example.com</customer_email>
    <customer_phone>+11234567890</customer_phone>
    <billing_address>
     <first_name>John</first_name>
     <last_name>Doe</last_name>
     <address1>32, Doestreet</address1>
     <address2></address2>
     <zip_code>12345</zip_code>
     <city>New York</city>
     <state>NY</state>
     <country>US</country>
    </billing_address>
  </payment_transaction>
  <payment_transaction>
    <status>approved</status>
    <authorization_code>345678</authorization_code>
    <response_code>00</response_code>
    <transaction_type>void</transaction_type>
    <unique_id>bad08183a9ec545daf0f24c48361aa10</unique_id>
    <transaction_id>mtid201104081447161135536962</transaction_id>
    <terminal_token>e9fd7a957845450fb7ab9dccb498b6e1f6e1e3aa</terminal_token>
    <mode>test</mode>
    <timestamp>2011-04-08T14:46:40Z</timestamp>
    <descriptor>e-comprocessing.net/bogus +49123456789</descriptor>
    <amount>5000</amount>
    <currency>USD</currency>
  </payment_transaction>
</wpf_payment>

    Example Error Response XML:

    <?xml version="1.0" encoding="UTF-8"?>
<wpf_payment>
  <status>error</status>
  <code>100</code>
  <technical_message>Unknown system error. Please contact support.</technical_message>
  <message>Transaction failed, please contact support!</message>
</wpf_payment>

    Reconcile by Date range

    Reconcile by Date can be used to retrieve data about payments in a date range. This can be useful if the merchant wants to retrieve information about payments belonging to the date range. For convenience, there are options to define records per page and the exact page of interest.

    Reconcile by Date requests are handled exactly like transaction requests in the Processing API. To a large degree, the WPF Reconcile follows the notions of the standard Reconcile in Processing API.

    The URL for date range reconcile is:

    https://staging.wpf.e-comprocessing.net/wpf/reconcile/by_date

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.wpf.e-comprocessing.net/wpf/reconcile/by_date \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <wpf_reconcile>
    <start_date>2019-06-20</start_date>
    <end_date>2019-09-18</end_date>
    <page>1</page>
    <records_per_page>100</records_per_page>
  </wpf_reconcile>'

    Request Parameters

    Parameter Required Format Description
    start_date required yyyy-mm-dd Start of the reconcile range
    end_date optional yyyy-mm-dd End of the reconcile date range
    page optional string(11) Number of the page
    records_per_page optional 1 to 3 digits Number ot records per page

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <wpf_payment>
    <status>approved</status>
    <unique_id>e27bd9472d40d3734a49e3e5c5ada52d</unique_id>
    <transaction_id>246d15a8644ff203fca6ae39fac8e999</transaction_id>
    <timestamp>2019-08-29</timestamp>
    <amount>500</amount>
    <currency>USD</currency>
  </wpf_payment>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the transaction, see states
    unique_id string(32) Unique id defined by gate (must later be used if capturing, voiding or refunding a transaction)
    transaction_id string(255) Unique transaction id defined by merchant
    timestamp string Time when the transaction was processed in ISO 8601 Combined date and time e.g. 2007-08- 30T17:46:11Z
    amount integer Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency string Currency code in ISO 4217

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <wpf_payment>
    <status>error</status>
    <code>340</code>
    <technical_message>start_date has an invalid format</technical_message>
    <message>Please check input data for errors!</message>
  </wpf_payment>

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <wpf_payment>
    <status>error</status>
    <code>320</code>
    <technical_message>start_date is missing</technical_message>
    <message>Please check input data for errors!</message>
  </wpf_payment>

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <wpf_payment>
    <status>error</status>
    <code>340</code>
    <technical_message>per_page has an invalid format</technical_message>
    <message>Please check input data for errors!</message>
  </wpf_payment>

    Error Response Parameters

    Parameter Type Description
    status string Status of the transaction, see states
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Errors

    WPF transaction types

    The web payment form supports the typical card-related transaction types such as authorizes, sales, and init recurring - with and without 3D (see below). If more than one card-based transaction type is passed, then if the cardholder decides to pay with a credit card, the first card-based transaction type with a valid configuration - terminals, MIDs, currencies, etc - is selected and used when cardholder decides to pay with a (credit) card.

    Also Account Verification for cards is supported by the web payment form. This is a transaction type for card verifications without any financial impact on cardholder's account. If ’account_verification’ is the only transaction type provided, the ’amount’ and the ’currency’ parameters are NOT mandatory. If it is combined with other transaction types, they are still mandatory and required.

    In addition, the WPF API supports a host of alternative payment methods (APMs), bank transfer payments, wallets, and more. All of the alternative transaction types are offered to the cardholder for payment, so the cardholder can choose between credit cards and alternatives defined by the merchant. Only credit cards or only a single alternative method can also work, there is no need to always offer credit cards for example.

    Merchant custom attributes for a number of the transaction types are required. The WPF API supports those merchant custom attributes - they are submitted as child elements to the transaction type they belong to(see WPF API example request above).

    The web payment form has the concept of a default payment method. If a given transaction type has the ’default’ attribute set to ’true’, then this transaction type will be pre-selected as default when the cardholder is redirected to the web payment form. If more than one transaction type has the ’default’ attribute, the first one with this attribute will be pre-selected. In the case there is only one transaction type requested (with or without the ’default’=’true’), this transaction type is automatically set as default by design.

    Note that for each transaction type requested by a merchant in the WPF API, a valid configuration should exist - valid terminal, currency, MID, web payment form enabled for the merchant, etc. - otherwise a configuration error will be raised. If this happens, contact the IT support team to resolve/configure your desired transaction types correctly.

    Example Request XML with custom attributes:

    <?xml version="1.0" encoding="UTF-8"?>
<wpf_payment>
  <transaction_id>wev238f328nc</transaction_id>
  <usage>Order ID 500, Shoes</usage>
  <description>You are about to buy 3 shoes at www.shoes.com!</description>
  <notification_url>https://example.com/notification</notification_url>
  <return_success_url>https://example.com/return_success</return_success_url>
  <return_failure_url>https://example.com/return_failure</return_failure_url>
  <return_cancel_url>https://example.com/return_cancel</return_cancel_url>
  <amount>5000</amount>
  <currency>USD</currency>
  <customer_email>john.doe@example.com</customer_email>
  <customer_phone>+11234567890</customer_phone>
  <card_holder>john doe</card_holder>
  <billing_address>
    <first_name>John</first_name>
    <last_name>Doe</last_name>
    <address1>23, Doestreet</address1>
    <zip_code>11923</zip_code>
    <city>New York City</city>
    <state>NY</state>
    <country>US</country>
  </billing_address>
  <transaction_types>
    <transaction_type name="sale">
      <bin>420000</bin>
      <tail>0000</tail>
      <expiration_date>2017-03</expiration_date>
    </transaction_type>
    <transaction_type name="sale3d" default="true">
      <tail>1111</tail>
      <expiration_date>2016-03</expiration_date>
    </transaction_type>
    <transaction_type name="cashu"/>
    <transaction_type name="ezeewallet">
      <source_wallet_id>john.doe@e-comprocessing.net</source_wallet_id>
    </transaction_type>
    <transaction_type name="paybyvoucher_yeepay">
      <product_name>Some Product Name</product_name>
      <product_category>Some Product Category</product_category>
      <card_type>virtual</card_type>
      <redeem_type>stored</redeem_type>
    </transaction_type>
    <transaction_type name="paybyvoucher_sale">
      <card_type>virtual</card_type>
      <redeem_type>stored</redeem_type>
    </transaction_type>
    <transaction_type name="citadel_payin">
      <merchant_customer_id>123456789</merchant_customer_id>
    </transaction_type>
  </transaction_types>
  <risk_params>
    <user_id>123456</user_id>
  </risk_params>
</wpf_payment>
    Transaction Type Custom Attribute Required Description
    authorize A standard authorization
    bin no Card’s first 6 digits
    tail no Card’s last 4 digits
    default no Configure as default or not
    expiration_date no Expiration month and year
    gaming no Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech-support@e-comprocessing.com for more details
    crypto no Signifies whether a purchase of cryptocurrency transaction is performed. Must be populated when purchasing cryptocurrency with a VISA card and MCC 6051. In this case, the gaming flag must be sent too. Contact tech-support@e-comprocessing.com for more details
    moto no Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech-support@e-comprocessing.com for more details.
    authorize3d A 3D-based authorization
    bin no Card’s first 6 digits
    tail no Card’s last 4 digits
    default no Configure as default or not
    expiration_date no Expiration month and year
    gaming no Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech-support@e-comprocessing.com for more details
    crypto no Signifies whether a purchase of cryptocurrency transaction is performed. Must be populated when purchasing cryptocurrency with a VISA card and MCC 6051. In this case, the gaming flag must be sent too. Contact tech-support@e-comprocessing.com for more details
    moto no Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech-support@e-comprocessing.com for more details.
    sale A standard sale
    bin no Card’s first 6 digits
    tail no Card’s last 4 digits
    default no Configure as default or not
    expiration_date no Expiration month and year
    gaming no Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech-support@e-comprocessing.com for more details
    crypto no Signifies whether a purchase of cryptocurrency transaction is performed. Must be populated when purchasing cryptocurrency with a VISA card and MCC 6051. In this case, the gaming flag must be sent too. Contact tech-support@e-comprocessing.com for more details
    moto no Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech-support@e-comprocessing.com for more details.
    sale3d A 3D-based sale
    bin no Card’s first 6 digits
    tail no Card’s last 4 digits
    default no Configure as default or not
    expiration_date no Expiration month and year
    gaming no Signifies whether a gaming transaction is performed. Gaming transactions usually use MCC 7995, contact tech-support@e-comprocessing.com for more details
    crypto no Signifies whether a purchase of cryptocurrency transaction is performed. Must be populated when purchasing cryptocurrency with a VISA card and MCC 6051. In this case, the gaming flag must be sent too. Contact tech-support@e-comprocessing.com for more details
    moto no Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech-support@e-comprocessing.com for more details.
    init_recurring_sale A standard init recurring
    bin no Card’s first 6 digits
    tail no Card’s last 4 digits
    default no Configure as default or not
    expiration_date no Expiration month and year
    init_recurring_sale3d A 3D-based init recurring
    bin no Card’s first 6 digits
    tail no Card’s last 4 digits
    default no Configure as default or not
    expiration_date no Expiration month and year
    account_verification Card verification without any financial impact
    bin no Card’s first 6 digits
    tail no Card’s last 4 digits
    default no Configure as default or not
    expiration_date no Expiration month and year
    moto no Signifies whether a MOTO (mail order telephone order) transaction is performed. Contact tech-support@e-comprocessing.com for more details.
    ezeewallet Wallet-based payment
    source_wallet_id no Email address of consumer who owns the source wallet
    default no Configure as default or not
    sofort Bank transfer payment, popular in Germany
    default no Configure as default or not
    cashu Voucher-based payment
    default no Configure as default or not
    paysafecard Voucher-based payment
    default no Configure as default or not
    ppro Supports payments with EPS, TeleIngreso, SafetyPay, TrustPay, Przelewy24, iDEAL, QIWI, GiroPay, Mr. Cash and MyBank
    default no Configure as default or not
    paybyvoucher_yeepay Buy a voucher via online bank transfer (oBeP), popular in China
    product_name yes Apply to order product information in the process of payment, and the prod- uct description of purchase
    product_category yes Type of commodity, includes 3C digits, clothing and shoes, bag and accessories, books and DVDS, tuition, reg- ister exam tuition, member fee, participation fee, logistic service, airline tickets, hotel catering, etc
    card_type yes Card type for the voucher - can be ’virtual’ or ’physical’ only
    redeem_type yes Redeem type for the voucher - can be ’stored’ or ’instant’ only
    default no Configure as default or not
    paybyvoucher_sale Buy a voucher via Credit Card
    card_type yes Card type for the voucher - can be ’virtual’ or ’physical’ only
    redeem_type yes Redeem type for the voucher - can be ’stored’ or ’instant’ only
    bin no Card’s first 6 digits
    tail no Card’s last 4 digits
    default no Configure as default or not
    expiration_date no Expiration month and year
    neteller Wallet-based payment
    default no Configure as default or not
    poli Payment by bank account for customers with an Australian or New Zealand bank account.
    default no Configure as default or not
    p24 Payment by bank account for customers with a Polish bank account.
    default no Configure as default or not
    citadel_payin Online Banking ePayment method
    default no Configure as default or not
    merchant_customer_id yes Identifier provided by the merchant that uniquely identifies the customer in their system
    idebit_payin Online Banking ePayment method
    default no Configure as default or not
    customer_account_id yes Identifier provided by the merchant that uniquely identifies the consumer in their system
    insta_debit_payin Online Banking ePayment method
    default no Configure as default or not
    customer_account_id yes Identifier provided by the merchant that uniquely identifies the consumer in their system
    paypal_express Express payment by PayPal balance.
    default no Configure as default or not
    abn_ideal Bank transfer payment, popular in Netherlands.
    webmoney Bank transfer payment, popular in Russian Federation.
    inpay Instant bank payment.
    sdd_sale SEPA Direct Debit Sale
    sdd_init_recurring_sale SEPA Direct Debit init recurring
    trustly_sale Solution for Online Banking ePayments.
    trustly_withdrawal Allows you to pay with your online bank.
    wechat Online Banking ePayment method
    product_code no Product code
    product_num no Product number
    product_desc no Product description

    WPF Internationalization (i18n)

    The web payment form is internationalized (i18n) and supports the following locales and corresponding languages:

    Locale Language Description
    en English English locale and language settings (this is the default)
    it Italian Italian locale and language settings
    es Spanish Spanish locale and language settings
    fr French French locale and language settings
    de German German locale and language
    ja Japanese Japanese locale and language
    zh Mandarin Chinese Mandarin Chinese locale and language
    ar Arabic Arabic locale and language
    pt Portuguese Portuguese locale and language
    tr Turkish Turkish locale and language
    ru Russian Russian locale and language
    hi Hindu Hindu locale and language
    bg Bulgarian Bulgarian locale and language
    id Indonesian Indonesian locale and language
    ms Malay Malay locale and language
    th Thai Thai locale and language
    cs Czech Czech locale and language
    hr Croatian Croatian locale and language
    sl Slovenian Slovenian locale and language

    Note that the English locale is the default, and if you don’t specify another locale in the WPF API, this is the locale and language that the web payment form will be translated into.

    The customer has the option to change the language once he has been redirected to the WPF via the received redirect_url.

    It is a good practice to submit the desired locale in the WPF API create call, so that a proper redirect_url is returned instead of manually parsing and generating a locale-specific redirect_url.

    If a locale/language different than the current ones is needed or any translation errors/inconsistencies are spotted, feel free to contact the IT Support team at tech-support@e-comprocessing.com and contribute to the translation effort.

    Authentication Services

    Introduction

    Authentication Services provide Strong Customer Authentication (SCA) which is a type of authentication relying on two or more independent elements.

    SCA as defined by the European Central Bank (ECB) and in the context of the EU’s Payment Services Directive (PSD2) is:

    ”a procedure based on the use of two or more of the following elements categorised as knowledge, ownership and inherence:

    In addition, the elements selected must be mutually independent, i.e. the breach of one does not compromise the other(s).

    At least one of the elements should be non-reusable and non-replicable (except for inherence), and not capable of being surreptitiously stolen via the Internet.

    The strong authentication procedure should be designed in such a way as to protect the confidentiality of the authentication data.”

    Using multiple solutions from the same category would not constitute SCA.

    SCA with 3DSecure

    Only the newest variant of 3DSecure involving one-time passwords (OTP) constitutes a form of SCA.

    3DSecure however might be a weak SCA solution for several reasons:

    1. it relies on the cards being actively enrolled by the cardholder after issuing, i.e prior any transaction made with it and

    2. it is not available on all card schemes.

    Alternative services

    A number of services exist that provide SCA in a compliant way.

    They rely on different solutions like generating payment ”secrets”, one-time passwords etc. Key advantage of such services is that they allow cards to be enrolled ”on-the-fly”, i.e. during a transaction rather than having to be pre-enrolled after issuing.

    Such services could potentially work with any card and are thus card scheme agnostic.

    Genesis KYC Services

    General Info

    Genesis KYC Services gives us the ability to perform particular checks on the integrity of the consumer data. Based on the returned consumer score we can decide whether we want to reject/approve a given transaction or perform another action for this consumer.

    Create Consumer Registration

    Review all aspects of the customer’s information, as it is received in the registration process, against local and external databases to increase accuracy and produce a risk score for that customer.

    POST /kyc_service/create_consumer

    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/create_consumer \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "customer_information": {
      "first_name": "John",
      "last_name": "Doe",
      "customer_email": "jdoe@example.com",
      "address1": "Sample Address",
      "address2": "4th floor",
      "city": "MyCity",
      "zip_code": "32132",
      "country": "BG",
      "province": "ProvinceName",
      "phone1": "0883113332",
      "phone2": "0883113334",
      "birth_date": "1987-03-03",
      "document_number": "f2345838972",
      "document_type": 3,
      "gender": "M"
    },
    "customer_unique_id": "21343253",
    "customer_registration_date": "2016-12-12",
    "customer_registration_ip_address": "255.255.255.255",
    "customer_username": "dimo16",
    "customer_registration_device_id": "12343242",
    "third_party_device_id": "3432424",
    "profile_action_type": 1,
    "device_fingerprint_type": 1,
    "current_profile_status": 1,
    "bonus_code": 1922,
    "bonus_amount": 100,
    "merchant_website": "dai.com",
    "how_did_you_hear": "friend",
    "affiliate_id": 1922
  }'

    Request Parameters

    Parameter Required Format Description
    session_id optional string If this value is not provided the user email account should be complete and valid
    customer_information required object Customer information. See below for each of the nested required fields
    customer_username optional string Username of the customer on your system
    customer_unique_id required string Unique user identificator on your system
    customer_registration_date required string Date in which the customer was registered in the system OR the date in which the customer was created in the cashier Database yyyy-mm-dd
    customer_registration_ip_address required string IP address of customer used when the customer was registered in the system OR the current IP address
    customer_registration_device_id optional string Propietary DeviceId technology, refer to the DeviceId Instruction Manual (provided on request)
    third_party_device_id optional string Third Party DeviceId
    device_fingerprint optional string Open Source DeviceId technologies (Intepreted as a String)
    device_fingerprint_type optional enum 1 - Custom; 2 - Open Source; 3 - Open Source 2;
    profile_action_type optional enum 1 - Registration;2 - Profile Update;
    profile_current_status optional enum 0 - Undefined;1 - Review;2 - Denied;3 - Approved;
    bonus_code optional string Open text variable. Represents the code entered by the customer
    bonus_submission_date optional string
    bonus_amount optional number
    merchant_website optional string
    industry_type optional string 1 - Finance; 2 - Gambling; 3 - Crypto; 4 - Travel; 5 - Retail; 6 - Risk Vendor; 7 - Adult; 8 - Remittance/Transfer; 9 - Other;
    how_did_you_hear optional string
    affiliate_id optional string
    rule_context optional number Number assigned to a given rule context. Please contact to get the available contexts

    required* = conditionally required

    Customer Information Fields

    The fields of the customer information object.

    Request Parameters

    Parameter Required Format Description
    first_name required string Customer first name
    middle_name optional string
    last_name required string Customer last name
    customer_email required string Must contain valid e-mail of customer
    address1 required string Primary address
    address2 optional string Secondary address
    city required string City
    province required string
    zip_code required string ZIP code
    country required string two-letter iso codes
    phone1 optional number
    phone2 optional number
    birth_date optional string Required for Visa only when MCC is a Financial Services one (e.g. MCC 6012)
    document_type optional enum 0 - SSN; 1 - Passport Registry; 2 - Personal ID / National ID; 3 - Identity Card; 4 - Driver License; 8 - Travel Document; 12 - Residence Permit; 13 - Identity Certificate; 16 - Registro Federal de Contribuyentes; 17 - Credencial de Elector; 18 - CPF
    document_number optional string
    gender optional enum F - female; M - male

    required* = conditionally required

      {
    "code": 0,
    "message": "Successful Response",
    "technical_message": "Successful Response",
    "details": [
      {
        "reference_id": "233",
        "risk_score": 98,
        "kyc_provider_recommendation": "Reject",
        "rules_triggered": [
          {
            "name": "Multi-Accounting : IP shared to Chargeback reason",
            "risk_score": "100.00",
            "display_to_merchant": 1
          }
        ],
        "scrubber_results": {
          "geo_check": "",
          "address_verification": "",
          "phone_verify": "",
          "idv_usa": "",
          "idv_global": "",
          "gav": "",
          "idv_br": "",
          "bav_usa": "",
          "bav_advanced": "",
          "cb_aml": "",
          "cb_bvs": "",
          "email_age": "",
          "compliance_watchlist": "",
          "iovation": "",
          "idv_advance": ""
        },
        "result_confidence_level": 91.5
      }
    ]
  }

    Successful Response Parameters

    Parameter Type Description
    code number genesis success code - 0
    message string const ’Successful Response’
    technical_message string const ’Successful Response’
    details
       reference_id string KYC provider internal id
       risk_score number risk score low is better
       kyc_provider_recommendation string KYC service provider recommendation
       result_confidence_level number Confidence level in percentages
       ... string additional response data

    Update Consumer Registration

    Update the customer registration to be able to pass on the latest status required so we can continue improving the data models and provide the best scores and recommendations possible.

    POST /kyc_service/update_consumer

    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/update_consumer \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "reference_id": "9999333344443",
    "profile_current_status": "21343253",
    "status_reason": "All good"
  }'

    Request Parameters

    Parameter Required Format Description
    reference_id required number Unique id returned by corresponding transaction
    profile_current_status required enum 0 - Undefined; 1 - Review; 2 - Denied; 3 - Approved;
    status_reason optional string Required only if status is Reject / Decline / Chargeback / Refund / Return / Void

    required* = conditionally required

    Make sure that reference_id points to a preliminary created transaction (will describe transactions below).

      {
    "code": 0,
    "message": "Successful Response",
    "technical_message": "Successful Response",
    "details": [
      {
        "reference_id": "9999333344443"
      }
    ]
  }

    Successful Response Parameters

    Parameter Type Description
    code number genesis success code - 0
    message string const ’Successful Response’
    technical_message string const ’Successful Response’
    details
       reference_id string KYC provider internal id

    Create Transaction

    Implement this to scrub a new transaction. We will take the information specific to that transaction and run various verification checks available, returning the recommendation, score, and third-party verification scrubbing results.

    POST /kyc_service/create_transaction

    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/create_transaction \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "customer_information": {
      "first_name": "John",
      "last_name": "Doe",
      "customer_email": "jdoe@example.com",
      "address1": "Sample address",
      "city": "Paris",
      "zip_code": "666",
      "country": "FR",
      "province": "MyProvince"
    },
    "deposit_limits": {
      "payment_method": "CC"
    },
    "transaction_unique_id": "1332",
    "payment_details": {
      "bin": "411111",
      "last_digits": "1111"
    },
    "customer_ip_address": "255.255.255.255",
    "transaction_created_at": "2016-12-12 23:23:23",
    "currency": "USD",
    "amount": 99999
  }'


    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/create_transaction \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "customer_information": {
      "first_name": "John",
      "last_name": "Doe",
      "customer_email": "jdoe@example.com",
      "address1": "Sample address",
      "city": "Paris",
      "zip_code": "666",
      "country": "FR",
      "province": "MyProvince"
    },
    "deposit_limits": {
      "payment_method": "EW"
    },
    "transaction_unique_id": "1332",
    "payment_details": {
      "ewallet_id": "411111"
    },
    "customer_ip_address": "255.255.255.255",
    "transaction_created_at": "2016-12-12 23:23:23",
    "currency": "USD",
    "amount": 99999
  }'


    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/create_transaction \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "customer_information": {
      "first_name": "John",
      "last_name": "Doe",
      "customer_email": "jdoe@example.com",
      "address1": "Sample address",
      "city": "Paris",
      "zip_code": "666",
      "country": "FR",
      "province": "MyProvince"
    },
    "deposit_limits": {
      "payment_method": "CC"
    },
    "transaction_unique_id": "1332",
    "payment_details": {
      "bin": "411111",
      "tail": "1111"
    },
    "customer_ip_address": "255.255.255.255",
    "transaction_created_at": "2016-12-12 23:23:23",
    "currency": "USD",
    "amount": 99999
  }'


    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/create_transaction \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "customer_information": {
      "first_name": "John",
      "last_name": "Doe",
      "customer_email": "jdoe@example.com",
      "address1": "Sample address",
      "city": "Paris",
      "zip_code": "666",
      "country": "FR",
      "province": "MyProvince"
    },
    "deposit_limits": {
      "payment_method": "EC"
    },
    "transaction_unique_id": "1332",
    "payment_details": {
      "bin": "411111",
      "tail": "4978784327847832784789"
    },
    "customer_ip_address": "255.255.255.255",
    "transaction_created_at": "2016-12-12 23:23:23",
    "currency": "USD",
    "amount": 99999
  }'

    Request Parameters

    Parameter Required Format Description
    session_id optional string If this value is not provided the user email account should be complete and valid
    customer_username optional string Username of the customer on your system
    customer_unique_id optional string Unique user identificator on your system
    customer_status optional string Customer loyalty level; for example: VIP; Bronze; Platinum; Gold; etc. This is an open text variable
    customer_loyalty_level optional string Customer loyalty level; for example: VIP; Bronze; Platinum; Gold; etc. This is an open text variable
    customer_registration_date optional string Date in which the customer was registered in the system OR the date in which the customer was created in the cashier Database yyyy-mm-dd
    customer_registration_ip_address optional string IP address of customer used when the customer was registered in the system OR the current IP address
    customer_registration_device_id optional string Propietary DeviceId technology, refer to the DeviceId Instruction Manual (provided on request)
    customer_information required object Customer information. See below for each of the nested required fields
    first_deposit_date optional string Empty if first deposit yyyy-mm-dd
    first_withdrawal_date optional string Empty if 0 withdrawals yyyy-mm-dd
    deposits_count optional number
    withdrawals_count optional number
    current_balance optional number
    deposit_limits required object See below
    transaction_unique_id required string Transaction id
    billing_information optional object See below
    shipping_information optional object See below
    payment_details required object See below
    amount optional number Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    currency optional string ISO 4217 Three digits
    transaction_created_at required string Represents the time of the transaction on the Merchant server. Format: yyyy-mmdd hh:mm:ss
    transaction_status optional enum Transaction status; it is recommended to send 0 on the initial call. Afterwards call Update Transaction endpoint to update the status. 0 - numberUndefined; 1 - number- Approved; 2 - number- Pre-Auth; 3 - number- Settled; 4 - number- Void; 5 - number- Rejected internally by Negative Database or other scrubber decided to reject the transaction; 6 - number- Declined the bank / gateway / processor rejected the transaction; 7 - number- Chargeback; 8 - number- Return;9 - number- Pending; 10 - number- Pass Transaction validation;11 - number- Failed Transaction validation; 12 - number- efund; 13 - number- Approved Review; 14 - number- Abandon This status is used when the user just leaves the transaction;
    customer_ip_address required string Customers IP address
    customer_device_id optional string Propietary DeviceId technology; refer to the DeviceId Instruction Manual (provided on request)
    third_party_device_id optional string Third Party DeviceId
    device_fingerprint optional string Open Source DeviceId technologies (Intepreted as a String)
    device_fingerprint_type optional enum 1 - Custom; 2 - Open Source; 3 - Open Source 2;
    shopping_cart_items_count optional number Represents the quantity of items in the shopping cart
    local_time optional string Represents the local time of the customer doing the transaction. Format: yyyy-mmdd hh:mm:ss
    order_source optional enum internet; mobile; inhouse
    merchant_website optional string Open text variable; it represents the website name or URL that submitted the transaction
    industry_type optional enum Definition of the industry type the transaction was performed on; 1-number - Finance; 2-number - Gambling; 3-number - Crypto; -number - Travel; 5-number - Retail; 6-number - Risk Vendor; 7-number - Adult; 8-number - Remittance/Transfer; 9-number - Other;
    customer_password optional string Open text variable; it represents the customers password in hashed format (using MD5) some companies share that information in order to look for patterns
    rule_context optional number Number assigned to a given rule context. Please contact to get the available contexts.
    custom_variable optional string Represents anything the merchant wants to store with this transaction

    required* = conditionally required

    Deposit Limits Fields

    Request Parameters

    Parameter Required Format Description
    payment_method required enum CC; EC; EW - CreditCard; Echeck; EWallet
    minimum optional number Lowest valid amount for deposit in minor currency units; ex: 100 = $1
    daily_maximum optional number In minor currency units
    weekly_maximum optional string In minor currency units
    monthly_maximum optional string In minor currency units

    required* = conditionally required

    Billing Information Fields

    Request Parameters

    Parameter Required Format Description
    first_name optional string Customer first name
    last_name optional string Customer last name
    customer_email optional string Must contain valid e-mail of customer
    address1 optional string Primary address
    address2 optional string Secondary address
    city optional string City
    province optional string
    zip_code optional string ZIP code
    country optional string ISO 3166-1 Alpha-2. For example: USD
    phone1 optional number Numbers only; no dash or any other separator. Please include area code if applicable. Country code is not required
    birth_date optional string yyyy-mm-dd
    gender optional enum M; F

    required* = conditionally required

    Shipping Information Fields

    Request Parameters

    Parameter Required Format Description
    first_name optional string Customer first name
    last_name optional string Customer last name
    customer_email optional string Must contain valid e-mail of customer
    address1 optional string Primary address
    address2 optional string Secondary address
    city optional string City
    province optional string
    zip_code optional string ZIP code
    country optional string ISO 3166-1 Alpha-2. For example: USD
    phone1 optional number Numbers only; no dash or any other separator. Please include area code if applicable. Country code is not required

    required* = conditionally required

    Payment Details Fields

    Request Parameters

    Parameter Required Format Description
    bin optional string First 6 digits of the card number; Only required if Payment Method Type is Credit Card;
    tail optional string Last 4 digits of the card number; Only required if Payment Method Type is Credit Card;
    cvv_present optional string Indicator if the CVV was received or not; The expected values in this field are Yes or No;
    hashed_pan optional string Only required if Payment Method Type is Credit Card; It should be hashed using SHA256; the string to be hashed is Card Numberand the MD5 hash of the Expiration Date; For example; if the card number is 1111-2222-3333-4444 with expiration date 01/22; The have should be done on the string without spaces nor dash nor other special chars; The MD5 of the Expiration Date 0122 is f0f4b6598f2cee45644673998b4f44be; That said; the string to be hashed is 1111222233334444f0f4b6598f2cee45644673998b4f44be which generates the following result fecd244b7d647b0db391e35910e0d42aaf88f7633a4f4f4883b109abad1d6d7
    routing optional string Routing number; Only required if Payment Method Type is eCheck;
    account optional string Only numbers up to 30 digits; Only required if Payment Method Type is eCheck;
    ewallet_id optional string Most of the times its an email; Only required if Payment Method Type is eWallet;

    required* = conditionally required

      {
    "code": 0,
    "message": "Successful Response",
    "technical_message": "Successful Response",
    "details": [
      {
        "reference_id": "481119",
        "kyc_provider_recommendation": "Approve",
        "risk_score": 0.39,
        "third_party": "",
        "processors": "",
        "reason": "",
        "result_confidence_level": 91.5,
        "rules_triggered": [
          {
            "name": "Address Verification : Global 25",
            "score": "0",
            "display_to_merchant": 1
          }
        ],
        "bin_information": {
          "bank_name": "BANCO NACIONAL DE COSTA RICA",
          "bank_location": "COSTA RICA",
          "card_type": "STANDARD",
          "card_level": "DEBIT",
          "iso_card_country": "CR",
          "card_brand_db": "MASTERCARD",
          "card_brand_script": "MASTERCARD"
        },
        "scrubber_results": {
          "geo_check": "",
          "address_verification": "",
          "phone_verify": "",
          "idv_usa": "",
          "idv_global": "",
          "gav": "",
          "idv_br": "",
          "bav_usa": "",
          "bav_advanced": "",
          "cb_aml": "",
          "cb_bvs": "",
          "email_age": "",
          "compliance_watchlist": "",
          "iovation": "",
          "idv_advance": ""
        }
      }
    ]
  }

    Successful Response Parameters

    Parameter Type Description
    code number genesis success code - 0
    message string const ’Successful Response’
    technical_message string const ’Successful Response’
    details
       reference_id string KYC provider internal id
       kyc_provider_recommendation string KYC provider recommendation
       risk_score number risk score low is better
       result_confidence_level number KYC service level of decision confidence
       ... * KYC provider additional data

    Update Transaction

    Utilize this method to update a particular transaction status so we can continue improving the data models and provide the best scores and recommendations.

    POST /kyc_service/update_transaction

    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/update_transaction \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "transaction_status": 1,
    "reference_id": "4454982",
    "reason": "a reason message",
    "transaction_unique_id": "1332",
    "cvv_check_result": "",
    "avs_check_result": "",
    "processor_identifier": ""
  }'


    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/update_transaction \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "transaction_status": 2,
    "transaction_unique_id": "1332"
  }'

    Request Parameters

    Parameter Required Format Description
    session_id optional string If this value is not provided the user email account should be complete and valid
    transaction_unique_id required string Transaction id
    reference_id optional number Required only if status is Reject / Decline / Chargeback / Refund / Return / Void
    transaction_status optional enum (number) 1-Approved; 2-Pre-Auth; 3-Settled; 4-Void; 5-Rejected internally by Negative Database or other scrubber decided to reject thetransaction; 6-Declined the bank / gateway / processor rejected the transaction; 7-Chargeback; 8-Return; 9-Pending; 10-Pass Transaction validation; 11-Failed ransaction validation; 12-Refund; 13-Approved Review; 14-Abandon This status is used when the user just leaves the transaction;
    reason optional string Required only if status is Reject / Decline / Chargeback / Refund / Return / Void
    cvv_check_result optional string Response from processor regarding CVV check
    avs_check_result optional string Result from processor regarding AVS check
    processor_identifier optional string Unique identifier of the processor attempted

    required* = conditionally required

      {
    "code": 0,
    "message": "Successful Response",
    "technical_message": "Successful Response",
    "details": [
      {
        "reference_id": "481119"
      }
    ]
  }

    Successful Response Parameters

    Parameter Type Description
    code number genesis success code - 0
    message string const ’Successful Response’
    technical_message string const ’Successful Response’
    details
       reference_id string KYC provider internal id

    Identity Document Upload

    Used to verify documents provided by the customer.

    When called this action returns the following:

    POST /kyc_service/upload_document

    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/upload_document \
   -X 3 \
   -H "Content-Type: application/json" \
   -d '
  {
    "transaction_unique_id": "1332",
    "doc": {
      "mime_type": "image/jpeg",
      "base64_content": "{base_64_endcoded_content}"
    }
  }'

    Request Parameters

    Parameter Required Format Description
    customer_username optional string Username of the customer on your system
    customer_unique_id optional string Unique user identificator on your system
    transaction_unique_id required* string Unique Transaction Id with info of the customer to be verified. Please note; if Transaction Id and Customer Registration Id are rovided the system will use the Transaction Id. Please provide the Transaction Id or the Customer Registration Id; one of them must be provided
    reference_id required* string Unique Customer Registration Id with info of the customer to be verified
    method required enum (number) 1 - Manual; 2 - OCR; 3 - Both;
    doc required object see below
    doc2; doc3; doc4 optional object additional document images

    required* = conditionally required

    One of transaction_unique_id and reference_id fields is required.

    Document Fields

    Request Parameters

    Parameter Required Format Description
    base64_content required string
    mime_type required string

    required* = conditionally required

      {
    "code": 0,
    "message": "Successful Response",
    "technical_message": "Successful Response",
    "details": [
      {
        "kyc_source": "OCR",
        "reference_id": "382"
      },
      {
        "kyc_source": "Semi-manual",
        "reference_id": "129"
      }
    ],
    "doc": "51f7e411cd1202e040b21655738beb89",
    "doc2": "b0139d3fb1785c1e57ac5a6b054692eb",
    "doc3": "e0059153192876ce8ab36d8cd8ab1bca"
  }

    Successful Response Parameters

    Parameter Type Description
    code number genesis success code - 0
    message string const ’Successful Response’
    technical_message string const ’Successful Response’
    details
       kyc_source string KYC service name triggered for verification
       reference_id string id used for reference when verification result is received

    Identity Document Download

    Uploaded documents will be stored by legal provisions and they can be requested for review. Just post a JSON body with the identity document id of the given document and a response with the filename and the base64 encoded content of that file would be returned.

    POST /kyc_service/download_document

    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/download_document \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "identity_document_id": "676a053b16781e43db7e75dcb1444ef8"
  }'

    Request Parameters

    Parameter Required Format Description
    identity_document_id required string document id

    required* = conditionally required

      {
    "code": 0,
    "message": "Successful Response",
    "technical_message": "Successful Response",
    "details": [
      {
        "document": {
          "file_name": "430d595c22dbae26ef39ed91c3aabb49.jpg",
          "base64_content": "{base_64_endcoded_content}"
        }
      }
    ]
  }

    Successful Response Parameters

    Parameter Type Description
    code number genesis success code - 0
    message string const ’Successful Response’
    technical_message string const ’Successful Response’
    details
       file_name string file name
       base64_content string base64 encoded document content

    Make call

    This method is used to make a call or send an SMS to a given phone number. This method is used to complement the verification process. The system will make a call and dictates the verification code to be typed in the website. The following is a transcript of the voice message the system will use when en-US is used as language:

    The following is an example of the SMS text the system will use when en-US is used as language:

    POST /kyc_service/create_authentication

    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/create_authentication \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "customer_username": "896342",
    "customer_unique_id": 2,
    "transaction_unique_id": "387783428790324",
    "customer_phone_number": "372489879342",
    "service_language": "bg",
    "security_code": "3423",
    "service_type": 1
  }'

    Request Parameters

    Parameter Required Format Description
    customer_username optional string Username of the customer on your system
    customer_unique_id optional string Unique user identificator on your system
    transaction_unique_id required string Transaction identification in the merchants system; If not provided the system won't be able to link with the transaction that is being verified
    customer_phone_number required string Phone number to call; It must be complete country code + phone number; No dashes; For example: 50622560000
    service_language required string a string value; See below
    security_code required string Numeric value - 4 digits only; It cannot start with 0; The boot is going to say this numeric value so the user can type it back on the website;
    service_type required string Numeric value to indicate if the system will send a text message or make a voice call; 1 for SMS; 2 for Voice call;

    required* = conditionally required

    Available languages for t_language

    Language Code
    Arabic a
    Cantonese, Chinese/Hong Kong zh-HK
    Catalan ca
    Croatian hr
    Czech cs
    Danish da
    Dutch nl
    English, Australian en-AU
    English, UK en-GB
    English, US en-US
    Estonian et
    Filipino fil
    Finnish fi
    French fr
    French, Canadian fr-CA
    German de
    Greek el
    Hebrew he
    Hindi hi
    Hungarian hu
    Icelandic is
    Indonesian id
    Italian it
    Japanese ja
    Korean ko
    Latvian lv
    Lingala ln
    Lithuanian lt
    Mandarin zh-CN
    Norwegian no
    Polish pl
    Portuguese, Brazilian pt-BR
    Portuguese, European pt
    Romanian ro
    Russian ru
    Slovakian sk
    Spanish, European es
    Spanish, Latin American es-419
    Swedish sv
    Thai th
    Turkish tr
    Ukrainian uk
    Vietnamese vi 
      {
    "code": 0,
    "message": "Successful Response",
    "technical_message": "Successful Response",
    "details": [
      {
        "reference_id": "233"
      }
    ]
  }

    Successful Response Parameters

    Parameter Type Description
    code number genesis success code - 0
    message string const ’Successful Response’
    technical_message string const ’Successful Response’
    details
       reference_id string id used for future reference

    Update call

    This method is used to update the call status with the latest info received from the main system. It also updates the transaction associated with this verification call.

    POST /kyc_service/update_authentication

    curl https://username:password@staging.gate.e-comprocessing.net/kyc_service/update_authentication \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "reference_id": 1237834,
    "security_code_input": "4322",
    "verification_status": "4"
  }'

    Request Parameters

    Parameter Required Format Description
    reference_id required string Unique value to identify the call in back office.
    security_code_input required string Transaction identification in the merchants system; If not provided the system won't be able to link with the transaction that is being verified
    verification_status required string The first two values are defined by the system when the call is created; the ones accepted in this call are the status 3; 4 and 5 only 1-In Progress; 2-Failed; 3-Verification Failed; 4-Verification Successful; 5-Abandon;

    required* = conditionally required

      {
    "code": 0,
    "message": "Successful Response",
    "technical_message": "Successful Response",
    "details": [
      {
        "reference_id": "233"
      }
    ]
  }

    Successful Response Parameters

    Parameter Type Description
    code number genesis success code - 0
    message string const ’Successful Response’
    technical_message string const ’Successful Response’
    details
       reference_id string id used for future reference

    Error Response

      {
    "code": 404,
    "message": "Passed attribute is invalid!",
    "technical_message": "The property ’#/’ did not contain a required property of ’customer_information’"
  }

      {
    "code": 803,
    "message": "KYC Services not configured!",
    "technical_message": "KYC Services not configured for Merchant!"
  }

    Error Response Parameters

    Parameter Type Description
    code number Genesis internal error code
    message string Short explanation of occurred error
    technical_message string More detailed explanation of occurred error

    Kyc Service Notification

    Since identity document verification is time consuming(can take up to 3-7 minutes) it is an asynchronous call. When verification is done a notification will be sent to configured Merchant notification url with all the details of the review along with the risk score. Note that multiple notifications can be expected so please always check the Score Complete parameter as if we have multiple DocumentId Verify providers, the score will be complemented with more info as we receive the data from the KYC sources. The count of expected notifications will be declared in initial IdentityDocumentUpload response.

    KYC Notification Example

    ?kyc_source=OCR
&reference_id=1912
&score=10
&score_complete=0
&uid=5486354658
&error_message=
&analysis_ref_uid=148871
&controls_identifier=MODEL_VALIDITY
&controls_title_msg=OK
&controls_result_msg=OK
&controls_result=OK
&controls_control_identifier=MODEL_RECOGNIZED
&controls_control_title_msg=OK
&controls_control_result_msg=OK
&controls_control_result=OK
&document_classification_id_type=V
&document_detail_emit_country=USA
&document_detail_expiration_date_day=23
&document_detail_expiration_date_month=12
&document_detail_expiration_date_year=2004
&document_detail_document_number=555123ABC
&document_detail_extra_infos_data_key=PERSONAL_NUMBER
&document_detail_extra_infos_data_value=IFLND00AMS803085
&document_detail_extra_infos_title=Personal_Number
&holder_detail_last_name=TRAVELER
&holder_detail_first_name=HAPPYPERSON
&holder_detail_nationality=GBR
&holder_detail_gender=F
&holder_detail_birth_date_day=5
&holder_detail_birth_date_month=2
&holder_detail_birth_date_year=1965
&mrz_line1=VIUSATRAVELER_HAPPYPERSON
&mrz_line2=555123ABC6GBR6502056F0412236IFLND00AMS803085
&check_report_summary_check_identifier=SUMMARY_ID_COPY
&check_report_summary_check_title_msg=OK
&check_report_summary_check_result_msg=Original_Document
&check_report_summary_check_result=OK
&notification_type=kyc_service_execution
&signature=secure-signature

    Notification Parameters Response Parameters

    Parameter Type Description
    kyc_source string name of the KYC source performed the validation
    reference_id string Unique id for reference to document upload request
    risk_score number Score product of validation rules
    external_unique_id string Unique ID Reference from External Service Provider
    analysis_reference_id string UniqueID Reference from Genesis
    controls_identifier string List of all MAIN controls performed on the document
    ... string Additional information related to verification process
    notification_type string constant value ”kyc service response”
    signature string the signature of the notification, should be used to verify the the notification was sent by Genesis

    The signature is a security measure meant to ensure that the gateway is really the sender of the notification. It is generated by concatenating the reference id with your API password and generating a SHA-512 Hash (Hex) of the string:

    SHA-512 Hash Hex of [reference_id][Your Merchant API password]

    Notification signature examples

    reference_id API password signature
    1912 password1 ecc5f441366aef60627a7fd2ad31e8c0e6d61d7cc3922e00fcdcf5cfbc2cc5ed67b9a3fa91a2c45ebd37c37acac6c543bed1f1146aea408c22741ffcd137fe75
    1818 password2 e03a2cdda2d75b7522a1c0b14d078ef017b000aa419c872a1e6489b8dd287e6bc6573feece5cf0db9bd3e6711eb9a7cf65a29b7a13ba5bad1de13d16ba448283

    When receiving the notification, you are required to render an XML page containing the transaction’s reference id so that the gateway knows that you have accepted the notification. If the XML is not delivered, the notification is sent periodically as per the rules for notifications delivery.

      <?xml version="1.0" encoding="UTF-8"?>
  <notification_echo>
    <reference_id nil="true"/>
  </notification_echo>

    Genesis Fx Services

    General Info

    Genesis Fx(Forex) Services provides the ability to retrieve up-to-date Fx rates. The API is synchronous and is based on RESTFul practices. Be sure to set Content-type: application/json in your headers.

    To interact with the Fx API, you need to provide login credentials using standard HTTP Basic Authentication. (credentials can be found in your Admin interface.)

    Get Tiers

    This call is used to return all Tiers that are related to your account.

    GET /v1/fx/tiers

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/v1/fx/tiers \
   -X GET \

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      [
    {
      "id": 1,
      "name": "Tier Name",
      "description": "Tier Description",
      "tier_id": "Tier Identifier",
      "enabled": true
    }
  ]

    Successful Response Parameters

    Parameter Type Description
    id number tier id - 1
    name string name of the tier
    description string description of the tier
    tier_id string identification of the tier
    enabled boolean state of the tier

    Get Tier

    This call is used to return information about selected Tier for your merchant.

    GET /v1/fx/tiers/:id

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/v1/fx/tiers/1 \
   -X GET \

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      {
    "id": 1,
    "name": "Tier Name",
    "description": "Tier Description",
    "tier_id": "Tier Identifier",
    "enabled": true
  }

    Successful Response Parameters

    Parameter Type Description
    id number tier id - 1
    name string name of the tier
    description string description of the tier
    tier_id string identification of the tier
    enabled boolean state of the tier

    Get Rates

    This call is used to return all rates for Tier.

    GET /v1/fx/tiers/:tier_id/rates

    Note: :tier_id is the ID of Tier, not to be mistaken with :tier_id of the same entity.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/v1/fx/tiers/1/rates \
   -X GET \

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      [
    {
      "id": 1,
      "source_currency": "Tier Name",
      "target_currency": "Tier Description",
      "trading_rate": "Tier Identifier",
      "enabled": null
    }
  ]

    Successful Response Parameters

    Parameter Type Description
    id number rate id - 1
    source_currency string source currency of the rate
    target_currency string target currency of the rate
    trading_rate string trading rate

    Get Rate

    This call is used to return information about selected Rate for merchant. GET /v1/fx/tiers/:tier_id/rates/:id

    Note: :tier_id is the ID of Tier, not to be mistaken with :tier_id of the same entity.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/v1/fx/tiers/1/rates/1 \
   -X GET \

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      {
    "id": 1,
    "source_currency": "Tier Name",
    "target_currency": "Tier Description",
    "trading_rate": "Tier Identifier",
    "enabled": null
  }

    Successful Response Parameters

    Parameter Type Description
    id number rate id - 1
    source_currency string source currency of the rate
    target_currency string target currency of the rate
    trading_rate string trading rate

    Search Rate

    This call is used to return information about selected Rate by currency pair.

    POST /v1/fx/tiers/:tier_id/rates/search

    Note: :tier_id is the ID of Tier, not to be mistaken with :tier_id of the same entity.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/v1/fx/tiers/:tier_id/rates/search \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "source_currency": "EUR",
    "target_currency": "USD"
  }'

    Request Parameters

    Parameter Required Format Description
    source_currency required string source currency
    target_currency required string target currency

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      {
    "id": 1,
    "source_currency": "Tier Name",
    "target_currency": "Tier Description",
    "trading_rate": "Tier Identifier",
    "enabled": null
  }

    Successful Response Parameters

    Parameter Type Description
    id number rate id - 1
    source_currency string source currency of the rate
    target_currency string target currency of the rate
    trading_rate string trading rate

    Consumers

    Introduction

    The Consumer entity brings Tokenization, Transactions and Web Payment Forms (WPF) together. It is a representation of a customer that can serve different purposes. A consumer is identified by providing both consumer ID and email. It is explicitly created via our Consumer API or implicitly by providing customer_email in either Transactions or WPF APIs. The main purpose of consumers is to group web payment forms and payment transactions. Using the merchant console, one can track consumers and find high-volume ones. The other role of consumers is to provide simplified, one-step tokenization of cardholder details. For Processing API that means securely storing card data in exchange for a token, which can be used for future payments. For WPF, customers can choose either to use previously stored cards or remember a new payment method.

    Consumer API

    Create consumer

    Creates a consumer based on email address. Optionally, one can provide billing and shipping address. Addresses will be used, if none given, in Processing or WPF APIs.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/create_consumer/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <create_consumer_request>
    <email>consumer@email.com</email>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <shipping_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10001</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </shipping_address>
  </create_consumer_request>'

    Request Parameters

    Parameter Required Format Description
    email required email address The consumer email address must be unique. If another consumer exists with this email address, the request will be rejected.
    billing_address optional See Required vs Optional API params for details
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <create_consumer_response>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <status>enabled</status>
  </create_consumer_response>

    Successful Response Parameters

    Parameter Type Description
    consumer_id string(10) Consumer unique reference
    email email address Consumer email address
    status string Status of the consumer

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <create_consumer_response>
    <status>error</status>
    <code>330</code>
    <technical_message>Invalid email format!</technical_message>
    <message>Something went wrong, please contact support!</message>
  </create_consumer_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the consumer
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Retrieve consumer

    Retrieves consumer details based on consumer id or email.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/retrieve_consumer/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <retrieve_consumer_request>
    <consumer_id>123456</consumer_id>
  </retrieve_consumer_request>'

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/retrieve_consumer/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <retrieve_consumer_request>
    <email>consumer@email.com</email>
  </retrieve_consumer_request>'

    Request Parameters

    Parameter Required Format Description
    consumer_id required string(10) Consumer unique reference. Required if the email is not provided
    email required email address Consumer email address. Required if the email is not provided

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <retrieve_consumer_response>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <status>enabled</status>
  </retrieve_consumer_response>

    Successful Response Parameters

    Parameter Type Description
    consumer_id string(10) Consumer unique reference
    email email address Consumer email address
    status string Status of the consumer

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <retrieve_consumer_response>
    <status>error</status>
    <code>702</code>
    <technical_message>Consumer not found!</technical_message>
    <message>Something went wrong, please contact support!</message>
  </retrieve_consumer_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the consumer
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Update consumer

    Updates consumer email and addresses.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/update_consumer/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <update_consumer_request>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <shipping_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10001</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </shipping_address>
  </update_consumer_request>'

    Request Parameters

    Parameter Required Format Description
    consumer_id required string(10) Consumer unique reference
    email required email address New email address
    billing_address optional See Required vs Optional API params for details
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166
    shipping_address optional
       first_name optional string(255) Customer first name
       last_name optional string(255) Customer last name
       address1 optional string(255) Primary address
       address2 optional string(255) Secondary address
       zip_code optional string ZIP code
       city optional string(255) City
       state optional string(2) State code in ISO 3166-2, required for USA and Canada
       country optional string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <update_consumer_response>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <status>enabled</status>
  </update_consumer_response>

    Successful Response Parameters

    Parameter Type Description
    consumer_id string(10) Consumer unique reference
    email email address Consumer email address
    status string Status of the consumer

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <update_consumer_response>
    <status>error</status>
    <code>702</code>
    <technical_message>Consumer not found!</technical_message>
    <message>Something went wrong, please contact support!</message>
  </update_consumer_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the consumer
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Disable consumer

    Disable consumer from usage until further action.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/disable_consumer/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <disable_consumer_request>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
  </disable_consumer_request>'

    Request Parameters

    Parameter Required Format Description
    consumer_id required string(10) Consumer unique reference
    email required email address Consumer email address

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <disable_consumer_response>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <status>disabled</status>
  </disable_consumer_response>

    Successful Response Parameters

    Parameter Type Description
    consumer_id string(10) Consumer unique reference
    email email address Consumer email address
    status string Status of the consumer

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <disable_consumer_response>
    <status>error</status>
    <code>702</code>
    <technical_message>Consumer not found!</technical_message>
    <message>Something went wrong, please contact support!</message>
  </disable_consumer_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the consumer
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Enable consumer

    Enable consumer that was disabled in the past.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/enable_consumer/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <enable_consumer_request>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
  </enable_consumer_request>'

    Request Parameters

    Parameter Required Format Description
    consumer_id required string(10) Consumer unique reference
    email required email address Consumer email address

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <enable_consumer_response>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <status>enabled</status>
  </enable_consumer_response>

    Successful Response Parameters

    Parameter Type Description
    consumer_id string(10) Consumer unique reference
    email email address Consumer email address
    status string Status of the consumer

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <enable_consumer_response>
    <status>error</status>
    <code>702</code>
    <technical_message>Consumer not found!</technical_message>
    <message>Something went wrong, please contact support!</message>
  </enable_consumer_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the consumer
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Get consumer cards

    Get previously tokenized card details for a consumer.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/get_consumer_cards/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <get_consumer_cards_request>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
  </get_consumer_cards_request>'

    Request Parameters

    Parameter Required Format Description
    consumer_id required string(10) Consumer unique reference
    email required email address Consumer email address

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <get_consumer_cards_response>
    <total>1</total>
    <card>
      <card_number>409603...0106</card_number>
      <card_holder>Travis Pastrana</card_holder>
      <expiration_month>12</expiration_month>
      <expiration_year>2020</expiration_year>
      <card_brand>master</card_brand>
    </card>
  </get_consumer_cards_response>

    Successful Response Parameters

    Parameter Type Description
    total string(255) Number of non-expired consumer cards
    card
       card_number string(13..21) Masked credit card number
       card_holder string(255) Full name of customer as printed on credit card (first name and last name at least)
       expiration_month MM Expiration month as printed on credit card
       expiration_year YYYY Expiration year as printed on credit card
       card_brand string Credit card brand

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <get_consumer_cards_response>
    <status>error</status>
    <code>702</code>
    <technical_message>Consumer not found!</technical_message>
    <message>Something went wrong, please contact support!</message>
  </get_consumer_cards_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the consumer
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Tokenization

    Introduction

    Tokenization is the process of replacing sensitive cardholder data with a surrogate value ("token"). The data to be tokenized must include at least the primary account number (PAN).

    Tokenization greatly reduces the sensitive data that businesses need to store, thus improving security of credit card transactions and minimizing the costs related to PCI DSS compliance.

    We issue reversible non-cryptographic tokens to merchants via our Tokenization API and take care to store safely the tokenized cardholder data. Merchants are able to use the issued tokens instead of the cardholder data when creating credit card transactions via our Processing API. PCI DSS compliant merchants have also the possibility to exchange the token for the original cardholder data via our Tokenization API ("detokenization").

    Tokenization API

    Accepted cardholder parameters

    All cardholder data parameters are accepted for tokenization - card number, cardholder, expiration year, expiration month. Please note - CVV is not accepted.

    Consumer required

    An enabled consumer is required in order to use this API. You have to create one or use existing, please check Consumer API.

    Tokenize

    Tokenizes cardholder data and issues a corresponding token. Merchants should take care to save the plain-text token value in their system as once issued it is not possible to obtain it again. Attempting to tokenize the same cardholder data will issue a new token. The token can be used in the Processing API instead of the cardholder data.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/tokenize/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <tokenize_request>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <token_type>uuid</token_type>
    <card_data>
      <card_number>4200000000000000</card_number>
      <card_holder>John Doe</card_holder>
      <expiration_month>05</expiration_month>
      <expiration_year>2020</expiration_year>
    </card_data>
  </tokenize_request>'

    Request Parameters

    Parameter Required Format Description
    consumer_id required string(10) Consumer unique reference
    email required e-mail address Consumer e-mail address
    token_type required uuid Token type format
    card_data required
       card_number required string(13..21) Complete cc number of customer
       card_holder optional string(255) Full name of customer as printed on credit card (first name and last name at least)
       expiration_month optional MM Expiration month as printed on credit card
       expiration_year optional YYYY Expiration year as printed on credit card

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <tokenize_response>
    <status>active</status>
    <token_id>34567</token_id>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <token_type>uuid</token_type>
    <consumer_id>123456</consumer_id>
  </tokenize_response>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the token
    token_id string(32) Unique token id
    token string(36) Plain-text token value
    token_type uuid Token type format
    consumer_id string(10) Consumer unique reference

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <tokenize_response>
    <status>error</status>
    <code>720</code>
    <technical_message>Invalid token type!</technical_message>
    <message>Something went wrong, please contact support!</message>
  </tokenize_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the token
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Detokenize

    Exchanges the token with the tokenized cardholder data

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/detokenize/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <detokenize_request>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <token_type>uuid</token_type>
  </detokenize_request>'

    Request Parameters

    Parameter Required Format Description
    consumer_id required string(10) Consumer unique reference
    email required e-mail address Consumer e-mail address
    token required string(36) Plain-text token value
    token_type required uuid Token type format

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <detokenize_response>
    <status>active</status>
    <token_id>34567</token_id>
    <token_type>uuid</token_type>
    <card_data>
      <card_number>4200000000000000</card_number>
      <card_holder>John Doe</card_holder>
      <expiration_month>05</expiration_month>
      <expiration_year>2020</expiration_year>
    </card_data>
  </detokenize_response>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the token
    token_id string(32) Unique token id
    token string(36) Plain-text token value
    token_type uuid Token type format
    card_data
       card_number string(13..21) Complete cc number of customer
       card_holder string(255) Full name of customer as printed on credit card (first name and last name at least)
       expiration_month MM Expiration month as printed on credit card
       expiration_year YYYY Expiration year as printed on credit card

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <detokenize_response>
    <status>error</status>
    <code>730</code>
    <technical_message>Invalid token!</technical_message>
    <message>Something went wrong, please contact support!</message>
  </detokenize_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the token
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Update token

    Updates the tokenized data corresponding to an existing valid token.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/update_token/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <update_token_request>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <token_type>uuid</token_type>
    <card_data>
      <card_number>4200000000000000</card_number>
      <card_holder>John Doe</card_holder>
      <expiration_month>05</expiration_month>
      <expiration_year>2020</expiration_year>
    </card_data>
  </update_token_request>'

    Request Parameters

    Parameter Required Format Description
    consumer_id required string(10) Consumer unique reference
    email required e-mail address Consumer e-mail address
    token required string(36) Plain-text token value
    token_type required uuid Token type format
    card_data required
       card_number required string(13..21) Complete cc number of customer
       card_holder optional string(255) Full name of customer as printed on credit card (first name and last name at least)
       expiration_month optional MM Expiration month as printed on credit card
       expiration_year optional YYYY Expiration year as printed on credit card

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <update_token_response>
    <status>active</status>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <token_type>uuid</token_type>
  </update_token_response>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the token
    token string(36) Plain-text token value
    token_type uuid Token type format

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <update_token_response>
    <status>error</status>
    <code>730</code>
    <technical_message>Invalid token!</technical_message>
    <message' nil="true"/>
  </update_token_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the token
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Validate Token

    Validates if a token is active, owned by a merchant, etc.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/validate_token/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <validate_token_request>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <token_type>uuid</token_type>
  </validate_token_request>'

    Request Parameters

    Parameter Required Format Description
    consumer_id required string(10) Consumer unique reference
    email required e-mail address Consumer e-mail address
    token required string(36) Plain-text token value
    token_type required uuid Token type format

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <validate_token_response>
    <status>active</status>
    <token_id>34567</token_id>
    <token_type>uuid</token_type>
  </validate_token_response>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the token
    token_id string(32) Unique token id
    token_type uuid Token type format

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <validate_token_response>
    <status>error</status>
    <code>720</code>
    <technical_message>Invalid token type!</technical_message>
    <message>Something went wrong, please contact support!</message>
  </validate_token_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the token
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Delete Token

    Deletes a token.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/delete_token/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <delete_token_request>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <token_type>uuid</token_type>
  </delete_token_request>'

    Request Parameters

    Parameter Required Format Description
    consumer_id required string(10) Consumer unique reference
    email required e-mail address Consumer e-mail address
    token required string(36) Plain-text token value
    token_type required uuid Token type format

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <delete_token_response>
    <status>active</status>
    <token_id>34567</token_id>
    <token_type>uuid</token_type>
  </delete_token_response>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the token
    token_id string(32) Unique token id
    token_type uuid Token type format

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <delete_token_response>
    <status>error</status>
    <code>720</code>
    <technical_message>Invalid token type!</technical_message>
    <message>Something went wrong, please contact support!</message>
  </delete_token_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the token
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    Get card

    Exchanges the token with the tokenized masked cardholder data

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/get_card/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <get_card_request>
    <consumer_id>123456</consumer_id>
    <email>consumer@email.com</email>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <token_type>uuid</token_type>
  </get_card_request>'

    Request Parameters

    Parameter Required Format Description
    consumer_id required string(10) Consumer unique reference
    email required e-mail address Consumer e-mail address
    token required string(36) Plain-text token value
    token_type required uuid Token type format

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <get_card_response>
    <status>active</status>
    <token_id>34567</token_id>
    <token_type>uuid</token_type>
    <card_data>
      <card_number>420000...0000</card_number>
      <card_holder>John Doe</card_holder>
      <expiration_month>05</expiration_month>
      <expiration_year>2020</expiration_year>
      <card_brand>visa</card_brand>
    </card_data>
  </get_card_response>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the token
    token_id string(32) Unique token id
    token string(36) Plain-text token value
    token_type uuid Token type format
    card_data
       card_number string(13..21) Complete cc number of customer
       card_holder string(255) Full name of customer as printed on credit card (first name and last name at least)
       expiration_month MM Expiration month as printed on credit card
       expiration_year YYYY Expiration year as printed on credit card

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <detokenize_response>
    <status>error</status>
    <code>730</code>
    <technical_message>Invalid token!</technical_message>
    <message>Something went wrong, please contact support!</message>
  </detokenize_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the token
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    How to tokenize cardholder data in Processing API

    In order to tokenize card details you need to set the remember_card flag to "true".

    Create a Consumer

    Please provide customer_email in addition to cardholder details and the remember_card flag. This will create a consumer and tokenize cardholder details. consumer_id and token will be returned in the response and notification. consumer_id will be returned in the reconcile response.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')
  ->setRememberCard('true');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");
    request.setRememberCard("true");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "remember_card": "true"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://staging.gate.e-comprocessing.net/process/TERMINAL_TOKEN/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <remember_card>true</remember_card>
  </payment_transaction>'

    Use existing consumer

    Please provide consumer_id and customer_email in addition to cardholder details and the remember_card flag. An existing consumer will be used, if identified. consumer_id and token will be returned in the response and notification. consumer_id will be returned in the reconcile response.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')
  ->setRememberCard('true')
  ->setConsumerId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");
    request.setRememberCard("true");
    request.setConsumerId("123456");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "expiration_month": "12",
    "expiration_year": 2020,
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "remember_card": "true",
    "consumer_id": "123456"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://staging.gate.e-comprocessing.net/process/TERMINAL_TOKEN/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <remember_card>true</remember_card>
    <consumer_id>123456</consumer_id>
  </payment_transaction>'

    How to use tokens in Processing API

    Requests

    Merchants can substitute cardholder parameters with tokens in the request when creating credit card transactions via our Processing API. Please note: merchants may choose to tokenize all cardholder parameters or only a subset. In the latter case the remaining parameters would need to be provided in the request. An enabled consumer is required to use tokens in Processing API. Please provide consumer_id and customer_email along with the token.

    All Cardholder Parameters Have Been Tokenized

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setToken('ee946db8-d7db-4bb7-b608-b65b153e127d')
  ->setCvv('834')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')
  ->setConsumerId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setToken("ee946db8-d7db-4bb7-b608-b65b153e127d");
    request.setCvv("834");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");
    request.setConsumerId("123456");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "token": "ee946db8-d7db-4bb7-b608-b65b153e127d",
    "cvv": "834",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "consumer_id": "123456"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://staging.gate.e-comprocessing.net/process/TERMINAL_TOKEN/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <cvv>834</cvv>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <consumer_id>123456</consumer_id>
  </payment_transaction>'

    Only Pan Has Been Tokenized

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setToken('ee946db8-d7db-4bb7-b608-b65b153e127d')
  ->setCardHolder('Travis Pastrana')
  ->setCvv('834')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')
  ->setConsumerId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setToken("ee946db8-d7db-4bb7-b608-b65b153e127d");
    request.setCardHolder("Travis Pastrana");
    request.setCvv("834");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");
    request.setConsumerId("123456");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "token": "ee946db8-d7db-4bb7-b608-b65b153e127d",
    "card_holder": "Travis Pastrana",
    "cvv": "834",
    "expiration_month": "12",
    "expiration_year": 2020,
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "consumer_id": "123456"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://staging.gate.e-comprocessing.net/process/TERMINAL_TOKEN/ \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>sale</transaction_type>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <token>ee946db8-d7db-4bb7-b608-b65b153e127d</token>
    <card_holder>Travis Pastrana</card_holder>
    <cvv>834</cvv>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <consumer_id>123456</consumer_id>
  </payment_transaction>'

    How to tokenize cardholder data in WPF API

    In order to offer saving a payment method for future use, set the remember_card flag to "true".

    Create a Consumer

    Please provide customer_email in addition to the remember_card flag. This will create a consumer and offer the user to save cardholder details (tokenize). consumer_id will be returned in the response and reconcile response. consumer_id and token will be returned in the notification.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('WPF\Create');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setDescription('You are about to buy 3 shoes at www.shoes.com!')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setReturnCancelUrl('http://www.example.com/cancel.html')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')
  ->setLifetime('60')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // Risk Params
  ->setRiskUserId('123456')


  // Transaction Types
  ->addTransactionType('authorize')
  ->addTransactionType('sale')
  ->setRememberCard('true');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.wpf.WPFCreateRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    WPFCreateRequest request = new WPFCreateRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setDescription("You are about to buy 3 shoes at www.shoes.com!");
    request.setNotificationUrl(new URL("https://www.example.com/notification"));
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setReturnCancelUrl(new URL("http://www.example.com/cancel.html"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");
    request.setLifetime(60);


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Risk Params
    request.setRiskUserId("123456");


    // Transaction Types
    request.addTransactionType("authorize").done();
    request.addTransactionType("sale").done();
    request.setRememberCard("true");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.wpf_create(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "description": "You are about to buy 3 shoes at www.shoes.com!",
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "return_cancel_url": "http://www.example.com/cancel.html",
    "amount": "100",
    "currency": "USD",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "lifetime": 60,
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "risk_params": {
      "user_id": "123456"
    },
    "transaction_types": [
      "authorize",
      "sale"
    ],
    "remember_card": "true"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://staging.wpf.e-comprocessing.net/wpf \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <wpf_payment>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <description>You are about to buy 3 shoes at www.shoes.com!</description>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <return_cancel_url>http://www.example.com/cancel.html</return_cancel_url>
    <amount>100</amount>
    <currency>USD</currency>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <lifetime>60</lifetime>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
    <transaction_types>
      <transaction_type>authorize</transaction_type>
      <transaction_type>sale</transaction_type>
    </transaction_types>
    <remember_card>true</remember_card>
  </wpf_payment>'

    Use existing consumer

    Please provide consumer_id and customer_email in addition to the remember_card flag. An existing consumer will be used, if identified, and offer the user to save cardholder details (tokenize). consumer_id will be returned in the response and reconcile response. consumer_id and token will be returned in the notification.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('WPF\Create');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setDescription('You are about to buy 3 shoes at www.shoes.com!')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setReturnCancelUrl('http://www.example.com/cancel.html')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')
  ->setLifetime('60')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // Risk Params
  ->setRiskUserId('123456')


  // Transaction Types
  ->addTransactionType('authorize')
  ->addTransactionType('sale')
  ->setRememberCard('true')
  ->setConsumerId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.wpf.WPFCreateRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    WPFCreateRequest request = new WPFCreateRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setDescription("You are about to buy 3 shoes at www.shoes.com!");
    request.setNotificationUrl(new URL("https://www.example.com/notification"));
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setReturnCancelUrl(new URL("http://www.example.com/cancel.html"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");
    request.setLifetime(60);


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Risk Params
    request.setRiskUserId("123456");


    // Transaction Types
    request.addTransactionType("authorize").done();
    request.addTransactionType("sale").done();
    request.setRememberCard("true");
    request.setConsumerId("123456");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.wpf_create(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "description": "You are about to buy 3 shoes at www.shoes.com!",
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "return_cancel_url": "http://www.example.com/cancel.html",
    "amount": "100",
    "currency": "USD",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "lifetime": 60,
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "risk_params": {
      "user_id": "123456"
    },
    "transaction_types": [
      "authorize",
      "sale"
    ],
    "remember_card": "true",
    "consumer_id": "123456"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://staging.wpf.e-comprocessing.net/wpf \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <wpf_payment>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <description>You are about to buy 3 shoes at www.shoes.com!</description>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <return_cancel_url>http://www.example.com/cancel.html</return_cancel_url>
    <amount>100</amount>
    <currency>USD</currency>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <lifetime>60</lifetime>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
    <transaction_types>
      <transaction_type>authorize</transaction_type>
      <transaction_type>sale</transaction_type>
    </transaction_types>
    <remember_card>true</remember_card>
    <consumer_id>123456</consumer_id>
  </wpf_payment>'

    How to use tokens in WPF API

    Please provide consumer_id and customer_email. An existing consumer will be used, if identified, and offer the user to select a previously stored card for payment.

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('WPF\Create');
$request = $genesis->request();

$request
  ->setTransactionId('43671')
  ->setUsage('40208 concert tickets')
  ->setDescription('You are about to buy 3 shoes at www.shoes.com!')
  ->setNotificationUrl('https://www.example.com/notification')
  ->setReturnSuccessUrl('http://www.example.com/success')
  ->setReturnFailureUrl('http://www.example.com/failure')
  ->setReturnCancelUrl('http://www.example.com/cancel.html')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCustomerEmail('travis@example.com')
  ->setCustomerPhone('+1987987987987')
  ->setLifetime('60')


  // Billing Address
  ->setBillingFirstName('Travis')
  ->setBillingLastName('Pastrana')
  ->setBillingAddress1('Muster Str. 12')
  ->setBillingZipCode('10178')
  ->setBillingCity('Los Angeles')
  ->setBillingState('CA')
  ->setBillingCountry('US')


  // Risk Params
  ->setRiskUserId('123456')


  // Transaction Types
  ->addTransactionType('authorize')
  ->addTransactionType('sale')
  ->setConsumerId('123456');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.wpf.WPFCreateRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;
import java.net.MalformedURLException;
import java.net.URL;

public class GenesisExample {
  public static void main() throws MalformedURLException {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    WPFCreateRequest request = new WPFCreateRequest();

    request.setTransactionId("43671");
    request.setUsage("40208 concert tickets");
    request.setDescription("You are about to buy 3 shoes at www.shoes.com!");
    request.setNotificationUrl(new URL("https://www.example.com/notification"));
    request.setReturnSuccessUrl(new URL("http://www.example.com/success"));
    request.setReturnFailureUrl(new URL("http://www.example.com/failure"));
    request.setReturnCancelUrl(new URL("http://www.example.com/cancel.html"));
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCustomerEmail("travis@example.com");
    request.setCustomerPhone("+1987987987987");
    request.setLifetime(60);


    // Billing Address
    request.setBillingFirstname("Travis");
    request.setBillingLastname("Pastrana");
    request.setBillingPrimaryAddress("Muster Str. 12");
    request.setBillingZipCode("10178");
    request.setBillingCity("Los Angeles");
    request.setBillingState("CA");
    request.setBillingCountry("US");


    // Risk Params
    request.setRiskUserId("123456");


    // Transaction Types
    request.addTransactionType("authorize").done();
    request.addTransactionType("sale").done();
    request.setConsumerId("123456");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.wpf_create(
  {
    "transaction_id": "43671",
    "usage": "40208 concert tickets",
    "description": "You are about to buy 3 shoes at www.shoes.com!",
    "notification_url": "https://www.example.com/notification",
    "return_success_url": "http://www.example.com/success",
    "return_failure_url": "http://www.example.com/failure",
    "return_cancel_url": "http://www.example.com/cancel.html",
    "amount": "100",
    "currency": "USD",
    "customer_email": "travis@example.com",
    "customer_phone": "+1987987987987",
    "lifetime": 60,
    "billing_address": {
      "first_name": "Travis",
      "last_name": "Pastrana",
      "address1": "Muster Str. 12",
      "zip_code": "10178",
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "risk_params": {
      "user_id": "123456"
    },
    "transaction_types": [
      "authorize",
      "sale"
    ],
    "consumer_id": "123456"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://staging.wpf.e-comprocessing.net/wpf \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <wpf_payment>
    <transaction_id>43671</transaction_id>
    <usage>40208 concert tickets</usage>
    <description>You are about to buy 3 shoes at www.shoes.com!</description>
    <notification_url>https://www.example.com/notification</notification_url>
    <return_success_url>http://www.example.com/success</return_success_url>
    <return_failure_url>http://www.example.com/failure</return_failure_url>
    <return_cancel_url>http://www.example.com/cancel.html</return_cancel_url>
    <amount>100</amount>
    <currency>USD</currency>
    <customer_email>travis@example.com</customer_email>
    <customer_phone>+1987987987987</customer_phone>
    <lifetime>60</lifetime>
    <billing_address>
      <first_name>Travis</first_name>
      <last_name>Pastrana</last_name>
      <address1>Muster Str. 12</address1>
      <zip_code>10178</zip_code>
      <city>Los Angeles</city>
      <state>CA</state>
      <country>US</country>
    </billing_address>
    <risk_params>
      <user_id>123456</user_id>
    </risk_params>
    <transaction_types>
      <transaction_type>authorize</transaction_type>
      <transaction_type>sale</transaction_type>
    </transaction_types>
    <consumer_id>123456</consumer_id>
  </wpf_payment>'

    Supported transaction types

    All transaction types accepting cardholder data are supported - Account Verification, Authorize, Authorize3D, Sale, Sale3D, InitRecurringSale, InitRecurringSale3D, Payout, Intersolve, Fashioncheque.

    Importation of external tokens and card details

    CSV file format

    CSV file headers:

    Header req? Description
    token required Plain-text token value (merchant/PSP token to migrate to us)
    token_type optional Token type format
    status optional Status of the token
    card_number required Credit card number
    card_holder required Full name of customer as printed on cc (first name and last name at least)
    expiration_month required Expiration month as printed on credit card
    expiration_year required Expiration year as printed on credit card
    email required Customer email
    first_name optional Customer first name used for billing address details
    last_name optional Customer last name used for billing address details
    address1 optional Customer primary address used for billing address details
    address2 optional Customer secondary address used for billing address details
    zip_code optional Zip code used for billing address details
    city optional Customer city used for billing address details
    state optional State code in ISO 3166-2, required for USA and Canada, used for billing address details
    country optional Country code in ISO 3166 used for billing address details

    Encryption of the CSV file

    The CSV contains sensitive data and therefore it must be encrypted. A public GPG key should be used for this purpose.

    Command to encrypt the file. It will generate encrypted file ending with .gpg extension:

    Uploading the encrypted CSV file to remote SFTP server

    Once the CSV file is encrypted it must be uploaded to our remote SFTP server for processing and importing its content.

    The remote SFTP connection has the following options which should be provided on demand (please, contact tech-support@e-comprocessing.com for more details):

    Commands to upload the encrypted CSV file to remote SFTP server:

    Once connected to the remote SFTP:

    Downloading a response CSV file from the remote SFTP server

    Once the tokens are imported in Genesis together with the relevant card details, a response CSV file would be generated. It will contain mapping between the tokens and the consumer ids and emails associated with them. They would be needed for successful usage of the imported tokens.

    Commands to retrieve the response CSV files from the remote SFTP server:

    Once connected to the remote SFTP:

    Transaction API

    Transaction Card Expiry Date Update API

    Each card-based transaction has an expiration date, which can be updated using the Transaction Card Expiry Date Update API.

    The API endpoint is suitable for recurring payments where the card has been renewed and has now a different expiration date.

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/v1/transaction/expiry_date/:transaction_unique_id \
   -X PUT \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <update_card_expiration_request>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
  </update_card_expiration_request>'

    Request Parameters

    Parameter Required Format Description
    expiration_month required MM Expiration month as printed on credit card
    expiration_year required YYYY Expiration year as printed on credit card

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <update_card_expiration_response>
    <status>success</status>
    <code>200</code>
    <message>Card expiry date updated successfully!</message>
  </update_card_expiration_response>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the response
    code integer Successful code (200)
    message string(255) Human readable error message which can be displayed to users.

    Error Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <update_card_expiration_response>
    <status>error</status>
    <code>300</code>
    <technical_message>The provided expiration date must be in the future and after the current one</technical_message>
    <message>Please check input data for errors!</message>
  </update_card_expiration_response>

    Error Response Parameters

    Parameter Type Description
    status string Status of the response
    code integer Error code according to Error code table
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).
    message string(255) Human readable error message which can be displayed to users.

    APM Services

    Klarna

    Introduction

    Klarna Services provides the ability for merchants to release remaining authorization, resend invoice, update order items or to update order address of a transaction.

    Release Remaining Authorization API

    The URL for Release Remaining Authorization API is:

    Production:

    https://gate.e-comprocessing.net/klarna/release_remaining_authorization

    Staging (for integration):

    https://staging.gate.e-comprocessing.net/klarna/release_remaining_authorization

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/klarna/release_remaining_authorization \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <release_remaining_authorization_request>
    <transaction_id>a1qf12e81eb23d0e00ffb85b1db7d152</transaction_id>
  </release_remaining_authorization_request>'

    Request Parameters

    Parameter Required Format Description
    transaction_id required string(255) Unique transaction id defined by merchant

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <release_remaining_authorization_request>
    <status>success</status>
    <technical_message>Transaction operation successful!</technical_message>
  </release_remaining_authorization_request>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the transaction, see states
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).

    Resend Invoice API

    The URL for Resend Invoice API is:

    Production:

    https://gate.e-comprocessing.net/klarna/resend_invoice

    Staging (for integration):

    https://staging.gate.e-comprocessing.net/klarna/resend_invoice

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/klarna/resend_invoice \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <resend_invoice_request>
    <transaction_id>a1qf12e81eb23d0e00ffb85b1db7d152</transaction_id>
  </resend_invoice_request>'

    Request Parameters

    Parameter Required Format Description
    transaction_id required string(255) Unique transaction id defined by merchant

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <resend_invoice_request>
    <status>success</status>
    <technical_message>Transaction operation successful!</technical_message>
  </resend_invoice_request>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the transaction, see states
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).

    Update Order Items API

    The URL for Update Order Items API is:

    Production:

    https://gate.e-comprocessing.net/klarna/update_order_items

    Staging (for integration):

    https://staging.gate.e-comprocessing.net/klarna/update_order_items

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/klarna/update_order_items \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <update_order_items_request>
    <transaction_id>a1qf12e81eb23d0e00ffb85b1db7d152</transaction_id>
    <amount>10000</amount>
    <items>
      <item>
        <type>physical</type>
        <reference>19-402-BG1</reference>
        <name>BatteryPowerPack</name>
        <quantity>1</quantity>
        <unit_price>5000</unit_price>
        <tax_rate>0</tax_rate>
        <total_amount>5000</total_amount>
        <total_discount_amount>0</total_discount_amount>
        <total_tax_amount>0</total_tax_amount>
      </item>
    </items>
  </update_order_items_request>'

    Request Parameters

    Parameter Required Format Description
    transaction_id required string(255) Unique transaction id defined by merchant
    amount required integer > 0 Amount of transaction in minor currency unit, see Currency and Amount Handling for details
    items required List with items
       item_type required string(255) Order line type. Possible values: Supported item types
       quantity required integer Non-negative. The item quantity
       unit_price required integer Minor units. Includes tax, excludes discount(max value: 100000000)
       total_amount required integer Includes tax and discount. Must match (quantity unit price) - total discount amount divided by quantity (max value: 100000000)
       reference optional string(255) Article number, SKU or similar
       name optional string(255) Descriptive item name
       tax_rate optional integer Non-negative. In percent, two implicit decimals. I.e 2500 = 25.00 percent
       total_discount_amount optional integer Non-negative minor units. Includes tax
       total_tax_amount optional integer Must be within 1 of total amount - total_amount * 10000 / (10000 + tax rate). Negative when type is discount
       image_url optional url URL to an image that can be later embedded in communications between Klarna and the customer. (max 1024 characters)
       product_url optional url URL to an image that can be later embedded in communications between Klarna and the customer. (max 1024 characters)
       quantity_unit optional string(8) Unit used to describe the quantity, e.g. kg, pcs... If defined has to be 1-8 characters
       product_identifiers optional List with product identifiers
          brand optional string(255) The product's brand name as generally recognized by consumers. If no brand is available for a product, do not supply any value
          category_path optional string(255) The product's category path as used in the merchant's webshop. Include the full and most detailed category and separate the segments with ' > '
          global_trade_item_number optional string(255) The product's Global Trade Item Number (GTIN). Common types of GTIN are EAN, ISBN or UPC. Exclude dashes and spaces, where possible
          manufacturer_part_number optional string(255) The product's Manufacturer Part Number (MPN), which - together with the brand - uniquely identifies a product. Only submit MPNs assigned by a manufacturer and use the most specific MPN possible
       merchant_data optional List with merchant data
          marketplace_seller_info optional string(255) Information for merchant marketplace

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <update_order_items_request>
    <status>success</status>
    <technical_message>Transaction operation successful!</technical_message>
  </update_order_items_request>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the transaction, see states
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).

    Update Order Address API

    The URL for Update Order Address API is:

    Production:

    https://gate.e-comprocessing.net/klarna/update_order_address

    Staging (for integration):

    https://staging.gate.e-comprocessing.net/klarna/update_order_address

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://staging.gate.e-comprocessing.net/klarna/update_order_address \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <update_order_address_request>
    <transaction_id>a1qf12e81eb23d0e00ffb85b1db7d152</transaction_id>
    <billing_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Berlin</city>
      <country>DE</country>
    </billing_address>
    <shipping_address>
      <first_name>Barney</first_name>
      <last_name>Rubble</last_name>
      <address1>14, Nerazdelni str</address1>
      <zip_code>1407</zip_code>
      <city>Berlin</city>
      <country>DE</country>
    </shipping_address>
  </update_order_address_request>'

    Request Parameters

    Parameter Required Format Description
    transaction_id required string(255) Unique transaction id defined by merchant
    billing_address required See Required vs Optional API params for details
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166
    shipping_address required
       first_name required* string(255) Customer first name
       last_name required* string(255) Customer last name
       address1 required* string(255) Primary address
       address2 required* string(255) Secondary address
       zip_code required* string ZIP code
       city required* string(255) City
       state required* string(2) State code in ISO 3166-2, required for USA and Canada
       country required string(2) Country code in ISO 3166

    required* = conditionally required

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <update_order_address_request>
    <status>success</status>
    <technical_message>Transaction operation successful!</technical_message>
  </update_order_address_request>

    Successful Response Parameters

    Parameter Type Description
    status string Status of the transaction, see states
    technical_message string(255) Technical error message (for internal use only, not to be displayed to users).

    TransferTo

    Introduction

    TransferTo API endpoint provides merchants with the ability to retrieve an up-to-date list of TransferTo Payers. Those are the institutions that provide the money to the consumers.

    Retrieve Payers API

    This request is used to retrieve up-to-date TransferTo Payers list.

    GET /transfer_to/payers

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/transfer_to/payers \
   -X GET \

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      <?xml version="1.0" encoding="UTF-8"?>
  <payers_response>
    <payers>
      <payer>
        <id>1</id>
        <name>Sample Payer 1</name>
        <currency>USD</currency>
        <country_iso_code>USA</country_iso_code>
        <service>BankAccount</service>
        <transaction_requirements>{"sample":"requirements"}</transaction_requirements>
      </payer>
      <payer>
        <id>2</id>
        <name>Sample Payer 2</name>
        <currency>EUR</currency>
        <country_iso_code>FRA</country_iso_code>
        <service>MobileWallet</service>
        <transaction_requirements>{"sample":"requirements"}</transaction_requirements>
      </payer>
    </payers>
  </payers_response>

    Successful Response Parameters

    Parameter Type Description
    payer
       id string ID of the Payer (used as payer_id in the TransferToPayout transaction)
       name string Name of the Payer
       currency string(3) The currency in which the Payer provides the money
       country_iso_code string(3) The ISO code of the country in which the Payer operates
       service string The service used by the Payer to provide the money
       transaction_requirements string(1024) JSON containing the Payer's requirements

    Errors

    Error groups table

    Code Name Description
    (100..199) Systems errors Transaction could not be processed and was not passed to issuer.
    (200..299) Communication errors Transaction could not be processed properly. Issuer could not be reached or returned invalid data. Errors 230 - 250 need to be reconciled as they might have been processed properly issuer-wise.
    (300..399) Input data errors Transactions cannot be processed due to invalid incoming data in your request.
    (400..499) Workflow errors Workflow errors will occur if you trigger a transaction that is not possible at this time in the workflow, e.g. a refund on a declined transaction.
    (500..599) Processing errors These errors occur when a transaction was declined by the issuer.
    (600..699) Risk errors Risk errors occur when any of the risk management systems will not let the transaction pass through.
    (700..799) Tokenization errors Tokenization related errors.
    (800..899) Genesis KYC Services errors Genesis KYC Services errors
    (900..999) Issuer errors Issuer errors occur when the issuer is unreachable or has other technical problems. If you experience this kind of errors, contact support.

    Error codes tables

    System Errors

    Code Name Description
    100 SystemError A general system error occurred
    101 MaintenanceError System is undergoing maintenance, request could not be handled.
    110 AuthenticationError Login failed. Check your API credentials.
    120 ConfigurationError Configuration error occurred, e.g. terminal not config- ured properly. Check terminal settings.

    Communication Errors

    Code Name Description
    200 CommunicationError Communication with issuer failed, please contact sup- port.
    210 ConnectionError Connection to issuer could not be established, please contact support.
    220 AccountError Issuer account data invalid, please contact support.
    230 TimeoutError Issuer does not respond within given timeframe - please reconcile
    240 ResponseError Issuer returned invalid response - please reconcile and contact support
    250 ParsingError Issuer response could not be parsed - please reconcile and contact support.

    Input Data Errors

    Code Name Description
    300 InputDataError Invalid were data sent to the API.
    310 InvalidTransactionTypeError Invalid transaction type was passed to API. See transaction types.
    320 InputDataMissingError Required argument is missing. Check parameters.
    330 InputDataFormatError Argument passed in invalid format. Check parame- ters.
    340 InputDataInvalidError Argument passed in valid format but makes no sense (e.g. incorrect country code or currency). Check pa- rameters.
    350 InvalidXmlError The input XML could not be parsed due to invalid code. Please check XML data.
    360 InvalidContentTypeError Missing or invalid content type: should be text/xml!

    Workflow Errors

    Code Name Description
    400 WorkflowError A transaction was triggered that is not possible at this time in the workflow, e.g. a refund on a declined transaction.
    410 ReferenceNotFoundError Reference transaction was not found.
    420 ReferenceWorkflowError Wrong Workflow specified.
    430 ReferenceInvalidatedError Reference transaction already invalidated!
    440 ReferenceMismatchError Data mismatch with reference, e.g. amount exceeds reference
    450 DoubletTransactionError Transaction doublet was detected, transaction was blocked. This happens if several transactions with same amount, cardholder, cc number, cvv and expiry date are sent within 5 minutes.
    460 TransactionNotFoundError The referenced transaction could not be found.
    470 ChargebackNotFoundError Chargeback not found!
    480 RetrievalRequestNotFoundError Retrieval Request not found!
    490 FraudReportNotFoundError Fraud Report not found!

    Processing Errors

    Code Name Description
    500 ProcessingError Transaction declined by issuer
    510 InvalidGiftCardError DOCUMENTATION MISSING
    510 InvalidCardError Transaction declined, Credit card number is invalid.
    520 ExpiredGiftCardError DOCUMENTATION MISSING
    520 ExpiredCardError Transaction declined, expiration date not in the future or date invalid.
    530 TransactionPendingError Transaction pending.
    540 CreditExceededError Amount excceds credit card limit.
    550 IssuingError The voucher could not be issued!

    Risk Errors

    Code Name Description
    600 RiskError Transaction declined by risk management
    601 InterchangeRejectError Interchange reject received for transaction!
    609 BinCountryCheckError Card bin does not match billing country
    610 CardBlacklistError Card is blacklisted
    611 BinBlacklistError BIN blacklisted.
    612 CountryBlacklistError Country blacklisted.
    613 IpBlacklistError IP address blacklisted.
    614 BlacklistError value from payment transaction or risk params is blacklisted.
    615 CardWhitelistError PAN Whitelist Filter blocked the transaction. This filter - like the above one - uses the PAN blacklist (BL) to perform CC number checks against the BL in the DB. This filter however will reject transactions from a CC with a number which is not whitelisted.
    620 CardLimitExceededError Card limit exceeded configured limits.
    621 TerminalLimitExceededError Terminal limits exceeded.
    622 ContractLimitExceededError MID limits exceeded.
    623 CardVelocityExceededError Velocity by unknown card exceeded!
    624 CardTicketSizeExceededError Ticketsize by unknown card exceeded!
    625 UserLimitExceededError User limit exceeded configured limits.
    626 MultipleFailureDetectionError Found user transaction declined by issuer. Try again later!
    627 CSDetectionError The CrossSellingFilter blocks duplicated transactions when an approved transaction has been found on an- other mid. That is, if the transaction has already been processed successfully on a di↵erent mid and within the specified time frame, context entity / scope and possibly within the issuer scope (or not), it will be rejected in order to prevent duplicates.
    628 RecurringLimitExceededError Amount/count by recurring subscription exceeded.
    629 IrisFilterDeclinedError Transaction declined by risk management.
    630 IrisFilterOnHoldError Transaction on hold, a manual review will be done
    690 AvsError Address Verification failed.
    691 MaxMindRiskError If a transaction is considered high risk by MaxMind minFraud service, a MaxMindRiskError is raised.
    692 ThreatMetrixRiskError Transaction declined by ThreatMetrix risk module.
    693 IpNotWhitelistedError Transaction declined by risk management, IP is NOT whitelisted!
    694 DomainBlacklistedError Transaction declined by risk management, domain is blacklisted!
    695 FraudError Risk Error: Please contact the risk team!
    696 IbanBlacklistError Transaction declined by risk management, iban blacklisted!

    Tokenization Errors

    Code Name Description
    701 ConsumerUniquenessError Consumer with this consumer_id, email combination already exists!
    702 InvalidConsumerError Consumer not found!
    703 DisabledConsumerError Consumer is disabled!
    700 TokenizationError General tokenization error.
    710 TokenizationNotEnabledError Tokenization is not enabled for the merchant or the terminal! Contact support.
    720 InvalidTokenTypeError Unsupported token type!
    730 InvalidTokenError Invalid token!
    740 DetokenizeForbiddenError Detokenize action is forbidden!

    KYC Errors

    Code Name Description
    800 KycServiceError General KYC Service Error
    801 DocumentMimeTypeUnsupportedError Uploaded document MIME type is not supported by KYC provider
    802 InvalidRequestAttributesError Passed attributes are invalid!
    803 KycServiceNotConfiguredError KYC Services not configured for Merchant!
    804 KycServiceProviderError KYC Service provider Error!
    805 KycServiceNotificationError Notification already received
    806 KycServiceUnacceptableMerchantStateError Merchant state does not allow using KYC Service API!

    Remote Errors

    Code Name Description
    900 RemoteError Some error occurred on the issuer. Contact support.
    910 RemoteSystemError Some error occurred on the issuer
    920 RemoteConfigurationError Issuer configuration error
    930 RemoteDataError Some passed data caused an error on the issuer
    940 RemoteWorkflowError Remote workflow error
    950 RemoteTimeoutError Issuer has timeouted with clearing network

    Client Integrations

    There are client libraries and examples for a few programming languages to ease the merchant integration effort:

    Language Github Description
    .NET Genesis .NET .NET client library
    Java Genesis Java Java client library
    Java Genesis Android Android client library
    Node.js Genesis Node Node.js client library
    PHP Genesis PHP PHP client library
    Swift Genesis Swift iOS client library

    Should you have any questions or suggestions regarding the client libraries and improvements, contact the IT Support team at tech-support@e-comprocessing.com.

    You can also fork the repo(s) and send us pull requests directly at our Github account.

    Client-side encryption

    The Client-side Encryption (CSE) allows merchants to accept payments on their website while encrypting card data in their customer's browser with our JavaScript encryption library.

    To help merchants encrypt all sensitive card data on the customer's side, E-ComProcessing hosts the JavaScript library and merchant's encryption key. In addition, the merchants can decide to host the library by themselves, but we strongly recommend the Client-side encryption library hosted by our services to be used.

    If the merchants want to use the Client-Side Encryption (CSE) library, it needs to contact tech-support@e-comprocessing.com in order to enable this feature for them. Then the merchant will be allowed to obtain the public key and the library in the merchant web console.

    Client side

    <head>
  ...
  <script src="https://{CDN}/encrypto-{VERSION}.js"
          integrity="sha512-lJxHl93A/b8peqxz/mdLj7jD58N2zvHiiYhw8...=="
          crossorigin="anonymous"></script>
</head>

<body>
  <form method="POST" action="/request-payment" id="encrypto-form">
    <div>
      <input type="text" data-encrypted-name="card_number"/>
      <input type="text" data-encrypted-name="card_holder"/>
      ...
      <input type="text" data-encrypted-name="cvv"/>
      ...
      <input type="text" name="country"/>
      <input type="text" name="city"/>
    </div>
    ...
    <input type="submit" value="Pay"/>
  </form>

  <script>
    var publicKey = '...';

    Encrypto.createEncryptedForm(publicKey, {   // Required
      // formId: 'encrypto-form',               // Optional
      // onSubmit: function(form) {             // Optional
      //   console.log(form.fields);
      // }
    })
  </script>
</body>

    First, the merchant needs to create a payment form integrated with the Client-Side Encryption (CSE) library which can be retrieved from the Client Side Encryption panel in the merchant console at the merchant configuration page.

    Make sure that payment form contains all required fields for the transaction type which it's going to be used. Consult with our Transactions documentation. Don't forget to replace the form action with the payment handler URL of the merchant's server.

    Flag all card input fields for encryption by annotating them with the data-encrypted-name attribute. The name attribute should not be used for card input fields. The fields allowed for encryption are card_holder, card_number, expiration_month, expiration_year, and cvv.

    Eventually, the form may have a custom ID attribute. The formId option can be used to set any string as an ID for the payment form. Make sure to update the HTML form with the configured option. They both must match.

    Options

    option type description
    formId string Use to set custom form ID. Default value encrypto-form
    onSubmit function Use to set custom on submit callback

    Prevent form submit action

      Encrypto.createEncryptedForm(publicKey, {
    onSubmit: function(form) {
      // console.log(form.fields);
    }
  })

    In the case of a single-page application or a form that uses AJAX, maybe it's not desirable the form to reload the page when the payment gets submitted. For that reason, we provide onSubmit option. This option gives access to all the form data(including the encrypted fields) and allows to submit it via any AJAX library.

    JavaScript only

    <head>
  ...
  <script src="https://{CDN}/encrypto-{VERSION}.js"
          integrity="sha512-lJxHl93A/b8peqxz/mdLj7jD58N2zvHiiYhw8...=="
          crossorigin="anonymous"></script>
</head>

<body>
  <script>
    var publicKey = '...';
    var cse = Encrypto.createEncryption(publicKey);

    let data = {
      cvv: '123',
      card_number: '42000...'
    };

    var encryptedData = cse.encrypt(data);
  </script>
</body>

    In case the merchant does not have an HTML form, our library provides HTML-independent encryption. In this scenario, it's important to remember it's the merchant responsibility to make sure the card data is encrypted before sending it to the server.

    The JavaScript-only option can be convenient in case of a more complex single-page application which relays on state management library before sending any data to the server.

    Server side

    From the merchant's server, an HTTP POST request needs to be made to the gateway API endpoints. The workflow is the same as in the classic Client Integrations. The only difference when the Client-Side Encryption (CSE) library is used is that our gateway will receive the card data encrypted.

    Do not worry about the decryption. Our gateway will handle the API request as a standard transaction. Make sure to always use the correct public key in the client-side code.

    Shopping Carts

    Genesis has a number of shopping cart plugins to ease the merchant integration effort:

    Shopping cart Github Marketplace Description
    Magento 1.x CE Magento CE Shopping cart plugin for Magento 1.x CE
    Magento 2.x CE Magento 2.x CE Shopping cart plugin for Magento 2.x CE
    OpenCart OpenCart OpenCart Extensions Shopping cart plugin for OpenCart
    osCommerce osCommerce osCommerce Add-Ons Shopping cart plugin for osCommerce
    PrestaShop PrestaShop Shopping cart plugin for PrestaShop
    Shopify Internal integration Internal integration Shopping cart Integration for Shopify
    WooCommerce WooCommerce Shopping cart plugin for WooCommerce
    X-Cart X-Cart Shopping cart plugin for X-Cart
    Zen Cart Zen Cart Zen Cart Plugins Shopping cart plugin for Zen Cart

    Should you have any questions or suggestions regarding the shopping cart plugins and improvements, contact the IT Support team at tech-support@e-comprocessing.com.

    You can also fork the repo(s) and send us pull requests directly at our Github account.

    Testing

    For testing first login to the gateway admin and create a terminal.

    The url for test admin is:

    https://staging.merchant.e-comprocessing.net/

    The api base url for test processing is:

    https://staging.gate.e-comprocessing.net/process/TERMINAL_TOKEN

    The api base url for test single transaction reconciling is:

    https://staging.gate.e-comprocessing.net/reconcile/TERMINAL_TOKEN

    The api base url for test date range reconciling is:

    https://staging.gate.e-comprocessing.net/reconcile/by_date/TERMINAL_TOKEN

    For testing the gateway the following credit card numbers can be used:

    card number card brand transaction result
    4200000000000000 Visa successful transaction
    4111111111111111 Visa transaction declined
    5555555555554444 Master Card successful transaction
    5105105105105100 Master Card transaction declined

    For 3DSecure testing the following credit card numbers can be used:

    card number card brand transaction result
    4711100000000000 Visa 3DSecure enrolled
    4012001037461114 Visa 3DSecure enrolled failing authentication
    4012001036853337 Visa 3DSecure unavailable - Card Not Participating
    4012001037484447 Visa Error in 3DSecure Network in first step of 3DS authentication process
    4012001036273338 Visa Error in 3DSecure Network in second (asynchronous) step of 3DS authentication process
    5420923878724339 MasterCard 3DSecure enrolled
    5185540810000019 MasterCard 3DSecure enrolled failing authentication
    5111010030175156 MasterCard 3DSecure unavailable - Card Not Participating
    5200828282828210 MasterCard Error in 3DSecure Network in first step of 3DS authentication process
    5204230080000017 MasterCard Error in 3DSecure Network in second (asynchronous) step of 3DS authentication process

    When redirected to the dummy authentication page you may enter any password you like.

    Status Page

    statuspage.io is a popular service allowing to track server status, infrastructure notifications, and others.

    Note that you can sign up for E-ComProcessing’s status page.

    It allows to sign up via email or SMS or both, and receive notifications for our payment services and any planned maintenance windows, upgrades, or similar in the future should the need arise.

    Infrastructure and Uptime

    Genesis is hosted in two data centers respectively in Berlin and Amsterdam, and features a state-of-the-art, active-active infrastructure setup. As such, it employs load balancing and failover on the DNS layer, and you should be using and requesting the API nodes and web apps only via their dedicated DNS names.

    No hard-coding of IP addresses should be performed on the customers’ systems, as this will prevent the customer to take advantage of the failover in case one of the data centers has issues or throughout maintenance windows and current processing happens through one data center only, however rare this might be. In addition, load balancing of the customers’ volume is also impacted if IP addresses are hardcoded.

    Finally, note that the DNS load balancing and failover layer has a TTL of 30 seconds, and will sense any issues returning the right IP addresses to use, for both API nodes and web apps alike, at all times.

    As a highly available payment gateway platform, Genesis strives to achieve an uptime SLA of 99.99 percent on a yearly basis.

    Penetration Testing Warning

    It is important that merchants read and understand the activities that are explicitly prohibited when using the payment gateway services.

    While merchants are encouraged to perform best practice security testing on their own websites and applications, merchants must ensure under all circumstances that scans exclude the payment gateway Web Payment Form (WPF), Processing API, and merchant console.

    Action prohibited?
    Penetration testing of any gateway services Prohibited
    Load testing Prohibited. During integration testing, ensure minimum number of requests
    Exploiting common security vulnerabilities Prohibited
    Injecting malicious data Prohibited
    Bypassing validation and security checks Prohibited
    Subverting ACLs and user permissions Prohibited
    Port scanning and service discovery Prohibited
    Usage of ping/traceroute Acceptable for short term debugging purposes

    Note that merchants that do not abide by the above policy will be immediately blacklisted, resulting in terminating access to the WPF, Processing API, and merchant console.

    AVS Status Codes

    When sending a transaction for address verification or card verification, one of the following responses from the issuing bank will be received.

    Code Summary VISA MasterCard
    A Partial Match Address matches, ZIP does not. Address matches, ZIP does not.
    B Partial Match (International Transaction) Street address match. Postal code not verified because of incompatible formats. (Acquirer sent both street address and postal code) Street addresses match. Postal code not verified due to incompatible formats. (Acquirer sent both street address and postal code.)
    C No Match (International Transaction) Street address and postal code not verified because of incompatible formats. (Acquirer sent both street address and postal code.) Street address and postal code not verified due to incompatible formats. (Acquirer sent both street address and postal code.)
    D Full Match (International Transaction) Street addresses and postal code match. Street addresses and postal codes match.
    F Full Match (UK only) Street address and postal code match. Applies to U.K. only. Street address and postal code match. Applies to U.K. only.
    G Not Supported (International Transaction) Address information not verified for international transaction. Address information not verified for international transaction.
    I No Match (International Transaction) Address information not verified. Address information not verified.
    M Full Match (International Transaction) Street addresses and postal code match. Street address and postal code match.
    N No Match Neither address nor postal code matches. Neither address nor postal code matches.
    P Partial Match (International Transaction) Postal codes match. Street address not verified because of incompatible formats. (Acquirer sent both street address and postal code.) Postal code match. Street address not verified because of incompatible formats. (Acquirer sent both street address and postal code.)
    R System Unavailable Retry, system unable to process. Retry, system unable to process.
    S Not Supported AVS currently not supported. AVS currently not supported.
    U System Unavailable No data from issuer/Authorization System. Information not available. No data from issuer/Authorization System. Information not available.
    W Partial Match (US only) Not applicable. If present, replaced with ”Z” by V.I.R Available for U.S. issuers only. For U.S. addresses, nine-digit postal code matches, address does not; for address outside the U.S., postal code matches, address does not.
    X Full Match Not applicable. For U.S. addresses, nine-digit postal code and address matches; for addresses outside the U.S., postal code and address match.
    Y Full Match For U.S. addresses, five-digit or nine-digit postal code and address matches. For U.S. addresses, five-digit postal code and address matches.
    Z Partial Match For U.S. addresses, five-digit or nine-digit postal code matches, address does not. For U.S. addresses, five-digit postal code matches, address does not.

    Level 3 Travel Data

    Level 3 travel data is supplied as optional data to the standard API request. If the supplied is valid travel data then the transaction will be processed as a travel transaction and will qualify for the travel Incentive rates. Otherwise the transaction will be processed normally as a regular transaction. Note that the travel data will be stored as part of the transaction in all cases.

    Travel data is supported for Authorize, Authorize3D, Capture, Sale, Sale3D, InitRecurringSale, InitRecurringSale3D, RecurringSale.

    The following travel types are supported Airline Itinerary Data (AID), Car Rental, Hotel Rental, Ancillary Charges, Misc Charges.

    Travel Types

    Airline Itinerary Data (AID)

    Airline Ticket transaction With Airline Itinerary Data (AID)

    MasterCard

    Contract Merchant Category Code must be 3000-3350, 4511, 4722, 4723 or 5962

    Master Card

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"ticket"=>{"ticket_number"=>123456789012345, "passenger_name"=>"Test Example", "customer_code"=>1, "issuing_carrier"=>"AAAA", "total_fare"=>5000, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2018-02-05", "carrier_code"=>12, "service_class"=>1, "origin_city"=>"VAR", "destination_city"=>"FRA", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6666", "departure_time"=>"11:37", "departure_time_segment"=>"A"}]}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"ticket"=>{"ticket_number"=>123456789012345, "passenger_name"=>"Test Example", "customer_code"=>1, "issuing_carrier"=>"AAAA", "total_fare"=>5000, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2018-02-05", "carrier_code"=>12, "service_class"=>1, "origin_city"=>"VAR", "destination_city"=>"FRA", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6666", "departure_time"=>"11:37", "departure_time_segment"=>"A"}]}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "ticket": {
        "ticket_number": 123456789012345,
        "passenger_name": "Test Example",
        "customer_code": 1,
        "issuing_carrier": "AAAA",
        "total_fare": 5000,
        "agency_name": "Agency",
        "agency_code": "AG001"
      },
      "legs": [
        {
          "departure_date": "2018-02-05",
          "carrier_code": 12,
          "service_class": 1,
          "origin_city": "VAR",
          "destination_city": "FRA",
          "stopover_code": 0,
          "fare_basis_code": 1,
          "flight_number": "W6666",
          "departure_time": "11:37",
          "departure_time_segment": "A"
        }
      ]
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <ticket>
        <ticket_number>123456789012345</ticket_number>
        <passenger_name>Test Example</passenger_name>
        <customer_code>1</customer_code>
        <issuing_carrier>AAAA</issuing_carrier>
        <total_fare>5000</total_fare>
        <agency_name>Agency</agency_name>
        <agency_code>AG001</agency_code>
      </ticket>
      <legs>
        <leg>
          <departure_date>2018-02-05</departure_date>
          <carrier_code>12</carrier_code>
          <service_class>1</service_class>
          <origin_city>VAR</origin_city>
          <destination_city>FRA</destination_city>
          <stopover_code>0</stopover_code>
          <fare_basis_code>1</fare_basis_code>
          <flight_number>W6666</flight_number>
          <departure_time>11:37</departure_time>
          <departure_time_segment>A</departure_time_segment>
        </leg>
      </legs>
    </travel>
  </payment_transaction>'

    Master Card Multiple Legs

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"ticket"=>{"ticket_number"=>123456789012345, "passenger_name"=>"Test Example", "customer_code"=>1, "issuing_carrier"=>"AAAA", "total_fare"=>5000, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2018-02-05", "carrier_code"=>12, "service_class"=>1, "origin_city"=>"VAR", "destination_city"=>"FRA", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6666", "departure_time"=>"11:37", "departure_time_segment"=>"A"}, {"departure_date"=>"2018-02-05", "carrier_code"=>12, "service_class"=>1, "origin_city"=>"VAR", "destination_city"=>"BER", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6666", "departure_time"=>"11:37", "departure_time_segment"=>"A"}]}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"ticket"=>{"ticket_number"=>123456789012345, "passenger_name"=>"Test Example", "customer_code"=>1, "issuing_carrier"=>"AAAA", "total_fare"=>5000, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2018-02-05", "carrier_code"=>12, "service_class"=>1, "origin_city"=>"VAR", "destination_city"=>"FRA", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6666", "departure_time"=>"11:37", "departure_time_segment"=>"A"}, {"departure_date"=>"2018-02-05", "carrier_code"=>12, "service_class"=>1, "origin_city"=>"VAR", "destination_city"=>"BER", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6666", "departure_time"=>"11:37", "departure_time_segment"=>"A"}]}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "ticket": {
        "ticket_number": 123456789012345,
        "passenger_name": "Test Example",
        "customer_code": 1,
        "issuing_carrier": "AAAA",
        "total_fare": 5000,
        "agency_name": "Agency",
        "agency_code": "AG001"
      },
      "legs": [
        {
          "departure_date": "2018-02-05",
          "carrier_code": 12,
          "service_class": 1,
          "origin_city": "VAR",
          "destination_city": "FRA",
          "stopover_code": 0,
          "fare_basis_code": 1,
          "flight_number": "W6666",
          "departure_time": "11:37",
          "departure_time_segment": "A"
        },
        {
          "departure_date": "2018-02-05",
          "carrier_code": 12,
          "service_class": 1,
          "origin_city": "VAR",
          "destination_city": "BER",
          "stopover_code": 0,
          "fare_basis_code": 1,
          "flight_number": "W6666",
          "departure_time": "11:37",
          "departure_time_segment": "A"
        }
      ]
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <ticket>
        <ticket_number>123456789012345</ticket_number>
        <passenger_name>Test Example</passenger_name>
        <customer_code>1</customer_code>
        <issuing_carrier>AAAA</issuing_carrier>
        <total_fare>5000</total_fare>
        <agency_name>Agency</agency_name>
        <agency_code>AG001</agency_code>
      </ticket>
      <legs>
        <leg>
          <departure_date>2018-02-05</departure_date>
          <carrier_code>12</carrier_code>
          <service_class>1</service_class>
          <origin_city>VAR</origin_city>
          <destination_city>FRA</destination_city>
          <stopover_code>0</stopover_code>
          <fare_basis_code>1</fare_basis_code>
          <flight_number>W6666</flight_number>
          <departure_time>11:37</departure_time>
          <departure_time_segment>A</departure_time_segment>
        </leg>
        <leg>
          <departure_date>2018-02-05</departure_date>
          <carrier_code>12</carrier_code>
          <service_class>1</service_class>
          <origin_city>VAR</origin_city>
          <destination_city>BER</destination_city>
          <stopover_code>0</stopover_code>
          <fare_basis_code>1</fare_basis_code>
          <flight_number>W6666</flight_number>
          <departure_time>11:37</departure_time>
          <departure_time_segment>A</departure_time_segment>
        </leg>
      </legs>
    </travel>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    travel required
       ticket required*
          ticket_number required* String(15) The number on the ticket.
          passenger_name required* String(29) The name of the passenger. May be the cardholder name if the passenger name is unavailable. Must not be blank.
          customer_code required* String(17) The customer code. Internal Reference.
          issuing_carrier optional String(4) Contains the standard abbreviation for the airline or railway carrier issuing the ticket.
          total_fare required* Integer Total amount of the ticket and should equal the amount of the transaction.
          agency_name optional String(30) An entry should be supplied if a travel agency issued the ticket.
          agency_code optional String(8) An entry should be supplied if a travel agency issued the ticket.
       legs required* Max legs 10
          leg required*
             departure_date required String(10) The departure date. Date can be in future.
             arrival_date required* String(10) The arrival date. Date can be in future.
             carrier_code required* String(2) Contains the standard abbreviation for the airline or railway carrier issuing the ticket. This should not contain all spaces or zeros. Code indicating name of carrier.
             service_class required* String(1) The service type. i.e. Coach, First Class. Required for reduced interchange.
             origin_city required* String(3) The originating airport name‘s standard abbreviation. This should not contain all spaces or zeroes.
             destination_city required* String(3) The destination airport or railway name‘s standard abbreviation.
             stopover_code required* String(1) A code indicating whether there was a direct or a non-direct flight or route on the same ticket number. Allowed values: 0, 1
             fare_basis_code optional String(6) A code that carriers assign to a particular ticket type, such as business class or discounted/ non-re fundable.
             flight_number optional String(5) The number that the operating or marketing carrier assigned.
             departure_time optional String(5) The time of departure provided by the airline or railway, per trip leg.
             departure_time_segment optional String(1) Departure Time Segment. Allowed values: A, P

    required* = conditionally required

    Visa

    Contract Merchant Category Code must be 3000-3350, 4511, 4722, 4723 or 5962

    Visa

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"ticket"=>{"ticket_number"=>12345, "passenger_name"=>"Emil Example", "customer_code"=>1, "restricted_ticket_indicator"=>1, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2018-02-01", "carrier_code"=>2, "service_class"=>3, "origin_city"=>"SOF", "destination_city"=>"VAR", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6666"}]}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"ticket"=>{"ticket_number"=>12345, "passenger_name"=>"Emil Example", "customer_code"=>1, "restricted_ticket_indicator"=>1, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2018-02-01", "carrier_code"=>2, "service_class"=>3, "origin_city"=>"SOF", "destination_city"=>"VAR", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6666"}]}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "ticket": {
        "ticket_number": 12345,
        "passenger_name": "Emil Example",
        "customer_code": 1,
        "restricted_ticket_indicator": 1,
        "agency_name": "Agency",
        "agency_code": "AG001"
      },
      "legs": [
        {
          "departure_date": "2018-02-01",
          "carrier_code": 2,
          "service_class": 3,
          "origin_city": "SOF",
          "destination_city": "VAR",
          "stopover_code": 0,
          "fare_basis_code": 1,
          "flight_number": "W6666"
        }
      ]
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <ticket>
        <ticket_number>12345</ticket_number>
        <passenger_name>Emil Example</passenger_name>
        <customer_code>1</customer_code>
        <restricted_ticket_indicator>1</restricted_ticket_indicator>
        <agency_name>Agency</agency_name>
        <agency_code>AG001</agency_code>
      </ticket>
      <legs>
        <leg>
          <departure_date>2018-02-01</departure_date>
          <carrier_code>2</carrier_code>
          <service_class>3</service_class>
          <origin_city>SOF</origin_city>
          <destination_city>VAR</destination_city>
          <stopover_code>0</stopover_code>
          <fare_basis_code>1</fare_basis_code>
          <flight_number>W6666</flight_number>
        </leg>
      </legs>
    </travel>
  </payment_transaction>'

    Visa Multiple Legs

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"ticket"=>{"ticket_number"=>123456789012345, "passenger_name"=>"Test Example", "customer_code"=>1, "restricted_ticket_indicator"=>1, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2018-02-01", "carrier_code"=>2, "service_class"=>3, "origin_city"=>"SOF", "destination_city"=>"VAR", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6666"}, {"departure_date"=>"2018-02-01", "carrier_code"=>2, "service_class"=>3, "origin_city"=>"VAR", "destination_city"=>"FRA", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6366"}]}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"ticket"=>{"ticket_number"=>123456789012345, "passenger_name"=>"Test Example", "customer_code"=>1, "restricted_ticket_indicator"=>1, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2018-02-01", "carrier_code"=>2, "service_class"=>3, "origin_city"=>"SOF", "destination_city"=>"VAR", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6666"}, {"departure_date"=>"2018-02-01", "carrier_code"=>2, "service_class"=>3, "origin_city"=>"VAR", "destination_city"=>"FRA", "stopover_code"=>0, "fare_basis_code"=>1, "flight_number"=>"W6366"}]}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "ticket": {
        "ticket_number": 123456789012345,
        "passenger_name": "Test Example",
        "customer_code": 1,
        "restricted_ticket_indicator": 1,
        "agency_name": "Agency",
        "agency_code": "AG001"
      },
      "legs": [
        {
          "departure_date": "2018-02-01",
          "carrier_code": 2,
          "service_class": 3,
          "origin_city": "SOF",
          "destination_city": "VAR",
          "stopover_code": 0,
          "fare_basis_code": 1,
          "flight_number": "W6666"
        },
        {
          "departure_date": "2018-02-01",
          "carrier_code": 2,
          "service_class": 3,
          "origin_city": "VAR",
          "destination_city": "FRA",
          "stopover_code": 0,
          "fare_basis_code": 1,
          "flight_number": "W6366"
        }
      ]
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <ticket>
        <ticket_number>123456789012345</ticket_number>
        <passenger_name>Test Example</passenger_name>
        <customer_code>1</customer_code>
        <restricted_ticket_indicator>1</restricted_ticket_indicator>
        <agency_name>Agency</agency_name>
        <agency_code>AG001</agency_code>
      </ticket>
      <legs>
        <leg>
          <departure_date>2018-02-01</departure_date>
          <carrier_code>2</carrier_code>
          <service_class>3</service_class>
          <origin_city>SOF</origin_city>
          <destination_city>VAR</destination_city>
          <stopover_code>0</stopover_code>
          <fare_basis_code>1</fare_basis_code>
          <flight_number>W6666</flight_number>
        </leg>
        <leg>
          <departure_date>2018-02-01</departure_date>
          <carrier_code>2</carrier_code>
          <service_class>3</service_class>
          <origin_city>VAR</origin_city>
          <destination_city>FRA</destination_city>
          <stopover_code>0</stopover_code>
          <fare_basis_code>1</fare_basis_code>
          <flight_number>W6366</flight_number>
        </leg>
      </legs>
    </travel>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    travel required
       ticket required*
          ticket_number required* String(15) The number on the ticket.
          passenger_name required* String(29) The name of the passenger. May be the cardholder name if the passenger name is unavailable. Must not be blank.
          customer_code required* String(17) The customer code. Internal Reference.
          restricted_ticket_indicator optional String(1) Space or 0 = No restriction, 1 = Restriction; Allowed values: Empty String, 0, 1
          agency_name optional String(30) An entry should be supplied if a travel agency issued the ticket.
          agency_code optional String(8) An entry should be supplied if a travel agency issued the ticket.
       legs required* Max legs 10
          leg required*
             departure_date required String(10) The departure date. Date can be in future.
             arrival_date required* String(10) The arrival date. Date can be in future.
             origin_city required* String(3) The originating airport name‘s standard abbreviation. This should not contain all spaces or zeroes.
             carrier_code required* String(2) Contains the standard abbreviation for the airline or railway carrier issuing the ticket. This should not contain all spaces or zeros. Code indicating name of carrier.
             service_class required* String(1) The service type. i.e. Coach, First Class. Required for reduced interchange.
             stopover_code required* String(1) A code indicating whether there was a direct or a non-direct flight or route on the same ticket number. Allowed values: 0, 1
             destination_city required* String(3) The destination airport or railway name‘s standard abbreviation.
             fare_basis_code optional String(6) A code that carriers assign to a particular ticket type, such as business class or discounted/ non-re fundable.
             flight_number optional String(5) The number that the operating or marketing carrier assigned.

    required* = conditionally required

    Car Rental

    MasterCard

    Contact Merchant Category Code must be 3351-3500, 4722, 4723 or 5962, 7512, 7513, 7519

    Master Card

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"rentals"=>{"car_rental"=>{"purchase_identifier"=>12478, "class_id"=>3, "pickup_date"=>"2018-02-05", "renter_name"=>"Emil Example", "return_city"=>"Varna", "return_state"=>"VAR", "return_country"=>"BGR", "return_date"=>"2018-02-06", "renter_return_location_id"=>12478, "customer_code"=>1}}}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"rentals"=>{"car_rental"=>{"purchase_identifier"=>12478, "class_id"=>3, "pickup_date"=>"2018-02-05", "renter_name"=>"Emil Example", "return_city"=>"Varna", "return_state"=>"VAR", "return_country"=>"BGR", "return_date"=>"2018-02-06", "renter_return_location_id"=>12478, "customer_code"=>1}}}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "rentals": {
        "car_rental": {
          "purchase_identifier": 12478,
          "class_id": 3,
          "pickup_date": "2018-02-05",
          "renter_name": "Emil Example",
          "return_city": "Varna",
          "return_state": "VAR",
          "return_country": "BGR",
          "return_date": "2018-02-06",
          "renter_return_location_id": 12478,
          "customer_code": 1
        }
      }
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <rentals>
        <car_rental>
          <purchase_identifier>12478</purchase_identifier>
          <class_id>3</class_id>
          <pickup_date>2018-02-05</pickup_date>
          <renter_name>Emil Example</renter_name>
          <return_city>Varna</return_city>
          <return_state>VAR</return_state>
          <return_country>BGR</return_country>
          <return_date>2018-02-06</return_date>
          <renter_return_location_id>12478</renter_return_location_id>
          <customer_code>1</customer_code>
        </car_rental>
      </rentals>
    </travel>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    travel required
       rentals required
          car_rental required
             purchase_identifier required* String(9) Rental Agreement Number / Hotel Folio Number.
             class_id required* String(4) The car rental classification. Allowed values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 9999
             pickup_date required String(10) Car rental Pick-up date.
             renter_name required* String(20) The Renter Name
             return_city required* String(18) The Rental Return City
             return_state required* String(3) The Rental Return State
             return_country required* String(3) The Rental Return Country
             return_date required String(10) Car Rental return date
             renter_return_location_id required* String(10) Expenses or Car Rental code, Address, phone number, etc. Identifying Rental Return Location.
             customer_code required* String(17) The customer code. Internal Reference.

    required* = conditionally required

    Visa

    Contract Merchant Category Code must be 3351-3500, 4722, 4723 or 5962, 7512, 7513, 7519

    Visa

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"rentals"=>{"car_rental"=>{"purchase_identifier"=>12478, "class_id"=>3, "pickup_date"=>"2018-02-05", "renter_name"=>"Emil Example", "return_city"=>"Varna", "return_state"=>"VAR", "return_country"=>"BGR", "return_date"=>"2018-02-06", "renter_return_location_id"=>12478, "customer_code"=>1}}}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"rentals"=>{"car_rental"=>{"purchase_identifier"=>12478, "class_id"=>3, "pickup_date"=>"2018-02-05", "renter_name"=>"Emil Example", "return_city"=>"Varna", "return_state"=>"VAR", "return_country"=>"BGR", "return_date"=>"2018-02-06", "renter_return_location_id"=>12478, "customer_code"=>1}}}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "rentals": {
        "car_rental": {
          "purchase_identifier": 12478,
          "class_id": 3,
          "pickup_date": "2018-02-05",
          "renter_name": "Emil Example",
          "return_city": "Varna",
          "return_state": "VAR",
          "return_country": "BGR",
          "return_date": "2018-02-06",
          "renter_return_location_id": 12478,
          "customer_code": 1
        }
      }
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <rentals>
        <car_rental>
          <purchase_identifier>12478</purchase_identifier>
          <class_id>3</class_id>
          <pickup_date>2018-02-05</pickup_date>
          <renter_name>Emil Example</renter_name>
          <return_city>Varna</return_city>
          <return_state>VAR</return_state>
          <return_country>BGR</return_country>
          <return_date>2018-02-06</return_date>
          <renter_return_location_id>12478</renter_return_location_id>
          <customer_code>1</customer_code>
        </car_rental>
      </rentals>
    </travel>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    travel required
       rentals required
          car_rental required
             purchase_identifier optional String(25) Rental Agreement Number / Hotel Folio Number
             pickup_date required* String(10) Car rental Pick-up date.
             return_date required* String(10) Car rental Return date.
             extra_charges optional Array(6) Additional charges added to customer bill after check-out. Each position can be used to indicate a type of charge; Allowed values: 1, 2, 3, 4, 5
             no_show_indicator optional String(1) No show indicator; Allowed values: 0, 1

    required* = conditionally required

    Hotel Rental

    MasterCard

    Contract Merchant Category Code must be 3501-3999, 4722, 4723 or 5962, 7011

    Master Card

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"rentals"=>{"hotel_rental"=>{"purchase_identifier"=>12478, "arrival_date"=>3, "departure_date"=>"2018-02-05", "customer_code"=>1}}}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"rentals"=>{"hotel_rental"=>{"purchase_identifier"=>12478, "arrival_date"=>3, "departure_date"=>"2018-02-05", "customer_code"=>1}}}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "rentals": {
        "hotel_rental": {
          "purchase_identifier": 12478,
          "arrival_date": 3,
          "departure_date": "2018-02-05",
          "customer_code": 1
        }
      }
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <rentals>
        <hotel_rental>
          <purchase_identifier>12478</purchase_identifier>
          <arrival_date>3</arrival_date>
          <departure_date>2018-02-05</departure_date>
          <customer_code>1</customer_code>
        </hotel_rental>
      </rentals>
    </travel>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    travel required
       rentals required
          hotel_rental required
             purchase_identifier required* String(10) Rental Agreement Number / Hotel Folio Number.
             arrival_date required String(10) Hotel check-in date.
             departure_date required String(10) The departure date. Date can be in future.
             customer_code required* String(17) The customer code. Internal Reference.

    required* = conditionally required

    Visa

    Contract Merchant Category Code must be 3501-3999, 4722, 4723 or 5962, 7011

    Visa

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"rentals"=>{"hotel_rental"=>{"purchase_identifier"=>2, "arrival_date"=>"2018-02-01", "extra_charges"=>467, "no_show_indicator"=>1}}}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"rentals"=>{"hotel_rental"=>{"purchase_identifier"=>2, "arrival_date"=>"2018-02-01", "extra_charges"=>467, "no_show_indicator"=>1}}}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "rentals": {
        "hotel_rental": {
          "purchase_identifier": 2,
          "arrival_date": "2018-02-01",
          "extra_charges": 467,
          "no_show_indicator": 1
        }
      }
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <rentals>
        <hotel_rental>
          <purchase_identifier>2</purchase_identifier>
          <arrival_date>2018-02-01</arrival_date>
          <extra_charges>467</extra_charges>
          <no_show_indicator>1</no_show_indicator>
        </hotel_rental>
      </rentals>
    </travel>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    travel required
       rentals required
          hotel_rental required
             purchase_identifier optional String(25) Rental Agreement Number / Hotel Folio Number
             arrival_date required* String(10) Hotel rental Pick-up date.
             departure_date required* String(10) Hotel rental Departure date.
             extra_charges optional Array(6) Additional charges added to customer bill after check-out. Each position can be used to indicate a type of charge. Allowed values: 2, 3, 4, 5, 6, 7
             no_show_indicator optional String(1) No show indicator; Allowed values: 0, 1

    required* = conditionally required

    Ancillary Charges

    Ancillary Charges

    Charges/fees related to the ticket. These transactions are processed on a separate transaction, referenced to Airline transaction with AID.

    MasterCard

    Used to identify only Baggage Charges.

    Contract Merchant Category Code must be 3000-3350, 4511, 4722, 4723 or 5962

    Master Card

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"ticket"=>{"ticket_reference_id"=>"8b7e3575e5605ea7e1895707a3e92837"}, "charges"=>{"charge"=>{"type"=>"BG"}}}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"ticket"=>{"ticket_reference_id"=>"8b7e3575e5605ea7e1895707a3e92837"}, "charges"=>{"charge"=>{"type"=>"BG"}}}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "ticket": {
        "ticket_reference_id": "8b7e3575e5605ea7e1895707a3e92837"
      },
      "charges": {
        "charge": {
          "type": "BG"
        }
      }
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <ticket>
        <ticket_reference_id>8b7e3575e5605ea7e1895707a3e92837</ticket_reference_id>
      </ticket>
      <charges>
        <charge>
          <type>BG</type>
        </charge>
      </charges>
    </travel>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    travel required
       ticket required
          ticket_reference_id required String(32) Unique id of the ticket transaction
       charges required
          charge required
             type required String(2) This field will contain the Service Category Code for the primary type of service that has been provided. Allowed values: BG

    required* = conditionally required

    Visa

    Used to identify charges for a number of ancillary services such as ticket upgrades, baggage fee, food & beverage purchases which are not purchased as part of the original ticket. Also used for charges/fees related to partial airline ticket refunds or ticket cancellations.

    Contract Merchant Category Code must be 3000-3350, 4511, 4722, 4723 or 5962

    Visa

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"ticket"=>{"ticket_reference_id"=>"8b7e3575e5605ea7e1895707a3e92837", "ticket_document_number"=>1111, "issued_with_ticket_number"=>12321}, "charges"=>{"charge"=>{"type"=>"BF", "sub_type"=>"BG"}}}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"ticket"=>{"ticket_reference_id"=>"8b7e3575e5605ea7e1895707a3e92837", "ticket_document_number"=>1111, "issued_with_ticket_number"=>12321}, "charges"=>{"charge"=>{"type"=>"BF", "sub_type"=>"BG"}}}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "ticket": {
        "ticket_reference_id": "8b7e3575e5605ea7e1895707a3e92837",
        "ticket_document_number": 1111,
        "issued_with_ticket_number": 12321
      },
      "charges": {
        "charge": {
          "type": "BF",
          "sub_type": "BG"
        }
      }
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <ticket>
        <ticket_reference_id>8b7e3575e5605ea7e1895707a3e92837</ticket_reference_id>
        <ticket_document_number>1111</ticket_document_number>
        <issued_with_ticket_number>12321</issued_with_ticket_number>
      </ticket>
      <charges>
        <charge>
          <type>BF</type>
          <sub_type>BG</sub_type>
        </charge>
      </charges>
    </travel>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    travel required
       ticket required
          ticket_reference_id required String(32) Unique id of the ticket transaction
          ticket_document_number required String(15) This field will contain the form number assigned by the carrier for the transaction.
          issued_with_ticket_number required String(15) If this purchase has a connection or relationship to another purchase, such as baggage fee for a passenger transport ticket, this field must contain the document number for the other purchase.
       charges required
          charge required
             type required String(2) This field will contain the Service Category Code for the primary type of service that has been provided. Allowed values: BF, BG, CF, CG, CO, FF, GF, GT, IE, LG, MD, ML, OT, PA, PT, SA, SB, SF, ST, TS, UN, UP, WI
             sub_type required String(2) This field will contain the Service Category Code for the secondary type of service that has been provided Allowed values: BF, BG, CF, CG, CO, FF, GF, GT, IE, LG, MD, ML, OT, PA, PT, SA, SB, SF, ST, TS, UN, UP, WI

    required* = conditionally required

    Miscellaneous Charges

    Miscellaneous charges related to the travel, but not related to the ticket.

    MasterCard

    Contract Merchant Category Code must be 3000-3350, 4511, 4722, 4723 or 5962

    Master Card

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"ticket"=>{"ticket_reference_id"=>"8b7e3575e5605ea7e1895707a3e92837"}, "charges"=>{"charge"=>{"type"=>"MISC"}}}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"ticket"=>{"ticket_reference_id"=>"8b7e3575e5605ea7e1895707a3e92837"}, "charges"=>{"charge"=>{"type"=>"MISC"}}}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "ticket": {
        "ticket_reference_id": "8b7e3575e5605ea7e1895707a3e92837"
      },
      "charges": {
        "charge": {
          "type": "MISC"
        }
      }
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <ticket>
        <ticket_reference_id>8b7e3575e5605ea7e1895707a3e92837</ticket_reference_id>
      </ticket>
      <charges>
        <charge>
          <type>MISC</type>
        </charge>
      </charges>
    </travel>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    travel required
       ticket required
          ticket_reference_id required String(32) Unique id of the ticket transaction
       charges required
          charge required
             type required String(4) This field will contain the Service Category Code for the primary type of service that has been provided. Allowed values: MISC

    required* = conditionally required

    Visa

    Contract Merchant Category Code must be 3000-3350, 4511, 4722, 4723 or 5962

    Visa

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Sale');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"ticket"=>{"ticket_reference_id"=>"8b7e3575e5605ea7e1895707a3e92837"}, "charges"=>{"charge"=>{"type"=>"MISC"}}}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.SaleRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    SaleRequest request = new SaleRequest();

    request.set...("");
    request.setTravel("{"ticket"=>{"ticket_reference_id"=>"8b7e3575e5605ea7e1895707a3e92837"}, "charges"=>{"charge"=>{"type"=>"MISC"}}}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.sale(
  {
    "...": "",
    "travel": {
      "ticket": {
        "ticket_reference_id": "8b7e3575e5605ea7e1895707a3e92837"
      },
      "charges": {
        "charge": {
          "type": "MISC"
        }
      }
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <ticket>
        <ticket_reference_id>8b7e3575e5605ea7e1895707a3e92837</ticket_reference_id>
      </ticket>
      <charges>
        <charge>
          <type>MISC</type>
        </charge>
      </charges>
    </travel>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    travel required
       ticket required
          ticket_reference_id required String(32) Unique id of the ticket transaction
       charges required
          charge required
             type required String(4) This field will contain the Service Category Code for the primary type of service that has been provided. Allowed values: MISC

    required* = conditionally required

    Special Cases

    Travel Authorize (3D) and Capture

    The Capture travel data is always merged with the Authorize travel data and overrides the Authorization fields (where they are present in both transactions) before validating. This makes the required travel data for Authorizations optional. This logic is applied for all Travel Types. Because of this, there are 4 scenarios for submitting travel Authorization and Capture.

    Travel Authorize (3D) and Travel Capture

    In this scenario the Authorize and Capture transaction requests are submitted with valid travel data. The travel data that will be used for the transaction processing is the data submitted with the Capture.

    Example Travel Authorize

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Authorize');
$request = $genesis->request();

$request
  ->setTransactionId('1915c52b28ff29edb12bc617ac102a03')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setCvv('834')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setTravel('{"ticket"=>{"ticket_number"=>12345678123456, "passenger_name"=>"Passenger 01", "customer_code"=>123, "restricted_ticket_indicator"=>0, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2017-03-10", "carrier_code"=>"VX", "service_class"=>"J", "origin_city"=>"DUB", "destination_city"=>"ATL", "stopover_code"=>1, "fare_basis_code"=>0, "flight_number"=>""}]}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.AuthorizeRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    AuthorizeRequest request = new AuthorizeRequest();

    request.setTransactionId("1915c52b28ff29edb12bc617ac102a03");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setCvv("834");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setTravel("{"ticket"=>{"ticket_number"=>12345678123456, "passenger_name"=>"Passenger 01", "customer_code"=>123, "restricted_ticket_indicator"=>0, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2017-03-10", "carrier_code"=>"VX", "service_class"=>"J", "origin_city"=>"DUB", "destination_city"=>"ATL", "stopover_code"=>1, "fare_basis_code"=>0, "flight_number"=>""}]}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.authorize(
  {
    "transaction_id": "1915c52b28ff29edb12bc617ac102a03",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "cvv": "834",
    "expiration_month": "12",
    "expiration_year": 2020,
    "travel": {
      "ticket": {
        "ticket_number": 12345678123456,
        "passenger_name": "Passenger 01",
        "customer_code": 123,
        "restricted_ticket_indicator": 0,
        "agency_name": "Agency",
        "agency_code": "AG001"
      },
      "legs": [
        {
          "departure_date": "2017-03-10",
          "carrier_code": "VX",
          "service_class": "J",
          "origin_city": "DUB",
          "destination_city": "ATL",
          "stopover_code": 1,
          "fare_basis_code": 0,
          "flight_number": ""
        }
      ]
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <transaction_id>1915c52b28ff29edb12bc617ac102a03</transaction_id>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <cvv>834</cvv>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <travel>
      <ticket>
        <ticket_number>12345678123456</ticket_number>
        <passenger_name>Passenger 01</passenger_name>
        <customer_code>123</customer_code>
        <restricted_ticket_indicator>0</restricted_ticket_indicator>
        <agency_name>Agency</agency_name>
        <agency_code>AG001</agency_code>
      </ticket>
      <legs>
        <leg>
          <departure_date>2017-03-10</departure_date>
          <carrier_code>VX</carrier_code>
          <service_class>J</service_class>
          <origin_city>DUB</origin_city>
          <destination_city>ATL</destination_city>
          <stopover_code>1</stopover_code>
          <fare_basis_code>0</fare_basis_code>
          <flight_number></flight_number>
        </leg>
      </legs>
    </travel>
  </payment_transaction>'

    Example Travel Capture

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Capture');
$request = $genesis->request();

$request
  ->setTransactionId('7fcc6097153beeec1dd1e71f643198d8')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setReferenceId('1f2ee425e7c3159c60743098071771eb')
  ->setTravel('{"ticket"=>{"ticket_number"=>12345678123456, "passenger_name"=>"Passenger 01", "customer_code"=>"", "restricted_ticket_indicator"=>0, "agency_name"=>"New Agency", "agency_code"=>"AGN001"}, "legs"=>[{"departure_date"=>"2017-03-10", "carrier_code"=>"VX", "service_class"=>"J", "origin_city"=>"DUB", "destination_city"=>"ATL", "stopover_code"=>1, "fare_basis_code"=>0, "flight_number"=>""}]}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.CaptureRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    CaptureRequest request = new CaptureRequest();

    request.setTransactionId("7fcc6097153beeec1dd1e71f643198d8");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setReferenceId("1f2ee425e7c3159c60743098071771eb");
    request.setTravel("{"ticket"=>{"ticket_number"=>12345678123456, "passenger_name"=>"Passenger 01", "customer_code"=>"", "restricted_ticket_indicator"=>0, "agency_name"=>"New Agency", "agency_code"=>"AGN001"}, "legs"=>[{"departure_date"=>"2017-03-10", "carrier_code"=>"VX", "service_class"=>"J", "origin_city"=>"DUB", "destination_city"=>"ATL", "stopover_code"=>1, "fare_basis_code"=>0, "flight_number"=>""}]}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.capture(
  {
    "transaction_id": "7fcc6097153beeec1dd1e71f643198d8",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "reference_id": "1f2ee425e7c3159c60743098071771eb",
    "travel": {
      "ticket": {
        "ticket_number": 12345678123456,
        "passenger_name": "Passenger 01",
        "customer_code": "",
        "restricted_ticket_indicator": 0,
        "agency_name": "New Agency",
        "agency_code": "AGN001"
      },
      "legs": [
        {
          "departure_date": "2017-03-10",
          "carrier_code": "VX",
          "service_class": "J",
          "origin_city": "DUB",
          "destination_city": "ATL",
          "stopover_code": 1,
          "fare_basis_code": 0,
          "flight_number": ""
        }
      ]
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>capture</transaction_type>
    <transaction_id>7fcc6097153beeec1dd1e71f643198d8</transaction_id>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <reference_id>1f2ee425e7c3159c60743098071771eb</reference_id>
    <travel>
      <ticket>
        <ticket_number>12345678123456</ticket_number>
        <passenger_name>Passenger 01</passenger_name>
        <customer_code></customer_code>
        <restricted_ticket_indicator>0</restricted_ticket_indicator>
        <agency_name>New Agency</agency_name>
        <agency_code>AGN001</agency_code>
      </ticket>
      <legs>
        <leg>
          <departure_date>2017-03-10</departure_date>
          <carrier_code>VX</carrier_code>
          <service_class>J</service_class>
          <origin_city>DUB</origin_city>
          <destination_city>ATL</destination_city>
          <stopover_code>1</stopover_code>
          <fare_basis_code>0</fare_basis_code>
          <flight_number></flight_number>
        </leg>
      </legs>
    </travel>
  </payment_transaction>'

    Non Travel Authorize (3D) and Travel Capture

    In this scenario the Authorize request doesn’t contain the travel data. Valid travel data is submitted in the Capture transaction request. The travel data that will be used for the transaction processing is the data submitted with the Capture.

    Example Non Travel Authorize

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Authorize');
$request = $genesis->request();

$request
  ->setTransactionId('1915c52b28ff29edb12bc617ac102a03')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setCvv('834')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.AuthorizeRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    AuthorizeRequest request = new AuthorizeRequest();

    request.setTransactionId("1915c52b28ff29edb12bc617ac102a03");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setCvv("834");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.authorize(
  {
    "transaction_id": "1915c52b28ff29edb12bc617ac102a03",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "cvv": "834",
    "expiration_month": "12",
    "expiration_year": 2020
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <transaction_id>1915c52b28ff29edb12bc617ac102a03</transaction_id>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <cvv>834</cvv>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
  </payment_transaction>'

    Example Travel Capture

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Capture');
$request = $genesis->request();

$request
  ->setTransactionId('7fcc6097153beeec1dd1e71f643198d8')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setReferenceId('1f2ee425e7c3159c60743098071771eb')
  ->setTravel('{"ticket"=>{"ticket_number"=>12345678123456, "passenger_name"=>"Passenger 01", "customer_code"=>"", "restricted_ticket_indicator"=>0, "agency_name"=>"New Agency", "agency_code"=>"AGN001"}, "legs"=>[{"departure_date"=>"2017-03-10", "carrier_code"=>"VX", "service_class"=>"J", "origin_city"=>"DUB", "destination_city"=>"ATL", "stopover_code"=>1, "fare_basis_code"=>0, "flight_number"=>""}]}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.CaptureRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    CaptureRequest request = new CaptureRequest();

    request.setTransactionId("7fcc6097153beeec1dd1e71f643198d8");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setReferenceId("1f2ee425e7c3159c60743098071771eb");
    request.setTravel("{"ticket"=>{"ticket_number"=>12345678123456, "passenger_name"=>"Passenger 01", "customer_code"=>"", "restricted_ticket_indicator"=>0, "agency_name"=>"New Agency", "agency_code"=>"AGN001"}, "legs"=>[{"departure_date"=>"2017-03-10", "carrier_code"=>"VX", "service_class"=>"J", "origin_city"=>"DUB", "destination_city"=>"ATL", "stopover_code"=>1, "fare_basis_code"=>0, "flight_number"=>""}]}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.capture(
  {
    "transaction_id": "7fcc6097153beeec1dd1e71f643198d8",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "reference_id": "1f2ee425e7c3159c60743098071771eb",
    "travel": {
      "ticket": {
        "ticket_number": 12345678123456,
        "passenger_name": "Passenger 01",
        "customer_code": "",
        "restricted_ticket_indicator": 0,
        "agency_name": "New Agency",
        "agency_code": "AGN001"
      },
      "legs": [
        {
          "departure_date": "2017-03-10",
          "carrier_code": "VX",
          "service_class": "J",
          "origin_city": "DUB",
          "destination_city": "ATL",
          "stopover_code": 1,
          "fare_basis_code": 0,
          "flight_number": ""
        }
      ]
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>capture</transaction_type>
    <transaction_id>7fcc6097153beeec1dd1e71f643198d8</transaction_id>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <reference_id>1f2ee425e7c3159c60743098071771eb</reference_id>
    <travel>
      <ticket>
        <ticket_number>12345678123456</ticket_number>
        <passenger_name>Passenger 01</passenger_name>
        <customer_code></customer_code>
        <restricted_ticket_indicator>0</restricted_ticket_indicator>
        <agency_name>New Agency</agency_name>
        <agency_code>AGN001</agency_code>
      </ticket>
      <legs>
        <leg>
          <departure_date>2017-03-10</departure_date>
          <carrier_code>VX</carrier_code>
          <service_class>J</service_class>
          <origin_city>DUB</origin_city>
          <destination_city>ATL</destination_city>
          <stopover_code>1</stopover_code>
          <fare_basis_code>0</fare_basis_code>
          <flight_number></flight_number>
        </leg>
      </legs>
    </travel>
  </payment_transaction>'

    Travel Authorize (3D) and Non Travel Capture

    In this scenario the Authorize request contains valid travel data. Travel data isn’t submitted in the Capture transaction request. In this case the Capture transaction will inherit the travel data from the Authorize transaction. The travel data that will be used for the transaction processing is the data submitted with the Authorize.

    Example Travel Authorize

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Authorize');
$request = $genesis->request();

$request
  ->setTransactionId('1915c52b28ff29edb12bc617ac102a03')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setCvv('834')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setTravel('{"ticket"=>{"ticket_number"=>12345678123456, "passenger_name"=>"Passenger 01", "customer_code"=>123, "restricted_ticket_indicator"=>0, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2017-03-10", "carrier_code"=>"VX", "service_class"=>"J", "origin_city"=>"DUB", "destination_city"=>"ATL", "stopover_code"=>1, "fare_basis_code"=>0, "flight_number"=>""}]}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.AuthorizeRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    AuthorizeRequest request = new AuthorizeRequest();

    request.setTransactionId("1915c52b28ff29edb12bc617ac102a03");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setCvv("834");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setTravel("{"ticket"=>{"ticket_number"=>12345678123456, "passenger_name"=>"Passenger 01", "customer_code"=>123, "restricted_ticket_indicator"=>0, "agency_name"=>"Agency", "agency_code"=>"AG001"}, "legs"=>[{"departure_date"=>"2017-03-10", "carrier_code"=>"VX", "service_class"=>"J", "origin_city"=>"DUB", "destination_city"=>"ATL", "stopover_code"=>1, "fare_basis_code"=>0, "flight_number"=>""}]}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.authorize(
  {
    "transaction_id": "1915c52b28ff29edb12bc617ac102a03",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "cvv": "834",
    "expiration_month": "12",
    "expiration_year": 2020,
    "travel": {
      "ticket": {
        "ticket_number": 12345678123456,
        "passenger_name": "Passenger 01",
        "customer_code": 123,
        "restricted_ticket_indicator": 0,
        "agency_name": "Agency",
        "agency_code": "AG001"
      },
      "legs": [
        {
          "departure_date": "2017-03-10",
          "carrier_code": "VX",
          "service_class": "J",
          "origin_city": "DUB",
          "destination_city": "ATL",
          "stopover_code": 1,
          "fare_basis_code": 0,
          "flight_number": ""
        }
      ]
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <transaction_id>1915c52b28ff29edb12bc617ac102a03</transaction_id>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <cvv>834</cvv>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <travel>
      <ticket>
        <ticket_number>12345678123456</ticket_number>
        <passenger_name>Passenger 01</passenger_name>
        <customer_code>123</customer_code>
        <restricted_ticket_indicator>0</restricted_ticket_indicator>
        <agency_name>Agency</agency_name>
        <agency_code>AG001</agency_code>
      </ticket>
      <legs>
        <leg>
          <departure_date>2017-03-10</departure_date>
          <carrier_code>VX</carrier_code>
          <service_class>J</service_class>
          <origin_city>DUB</origin_city>
          <destination_city>ATL</destination_city>
          <stopover_code>1</stopover_code>
          <fare_basis_code>0</fare_basis_code>
          <flight_number></flight_number>
        </leg>
      </legs>
    </travel>
  </payment_transaction>'

    Example Non Travel Capture

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Capture');
$request = $genesis->request();

$request
  ->setTransactionId('7fcc6097153beeec1dd1e71f643198d8')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setReferenceId('1f2ee425e7c3159c60743098071771eb');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.CaptureRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    CaptureRequest request = new CaptureRequest();

    request.setTransactionId("7fcc6097153beeec1dd1e71f643198d8");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setReferenceId("1f2ee425e7c3159c60743098071771eb");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.capture(
  {
    "transaction_id": "7fcc6097153beeec1dd1e71f643198d8",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "reference_id": "1f2ee425e7c3159c60743098071771eb"
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>capture</transaction_type>
    <transaction_id>7fcc6097153beeec1dd1e71f643198d8</transaction_id>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <reference_id>1f2ee425e7c3159c60743098071771eb</reference_id>
  </payment_transaction>'

    Partial Travel Authorize (3D) and Partial Travel Capture

    In this scenario the Authorize request contains only part of the travel data. The Capture transaction request contains also part of the travel data. The travel data from the Authorize will be merged with the Capture travel data. The Capture travel data will complete/override the travel fields in the Authorize. This merged data will be stored as Capture travel data. If the merged data is valid travel data then the transaction will be processed as travel using the travel data stored in the Capture. Otherwise the transaction will be processed as a regular Capture transaction.

    Example Partial Authorize

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Cards\Authorize');
$request = $genesis->request();

$request
  ->setTransactionId('1915c52b28ff29edb12bc617ac102a03')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setCardHolder('Travis Pastrana')
  ->setCardNumber('4200000000000000')
  ->setCvv('834')
  ->setExpirationMonth('12')
  ->setExpirationYear('2020')
  ->setTravel('{"ticket"=>{}, "legs"=>[{"departure_date"=>"2017-03-10", "carrier_code"=>"VX", "service_class"=>"J", "origin_city"=>"DUB", "destination_city"=>"ATL", "stopover_code"=>1, "fare_basis_code"=>0, "flight_number"=>""}]}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.card.AuthorizeRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    AuthorizeRequest request = new AuthorizeRequest();

    request.setTransactionId("1915c52b28ff29edb12bc617ac102a03");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setCardHolder("Travis Pastrana");
    request.setCardNumber("4200000000000000");
    request.setCvv("834");
    request.setExpirationMonth("12");
    request.setExpirationYear("2020");
    request.setTravel("{"ticket"=>{}, "legs"=>[{"departure_date"=>"2017-03-10", "carrier_code"=>"VX", "service_class"=>"J", "origin_city"=>"DUB", "destination_city"=>"ATL", "stopover_code"=>1, "fare_basis_code"=>0, "flight_number"=>""}]}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.authorize(
  {
    "transaction_id": "1915c52b28ff29edb12bc617ac102a03",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "card_holder": "Travis Pastrana",
    "card_number": "4200000000000000",
    "cvv": "834",
    "expiration_month": "12",
    "expiration_year": 2020,
    "travel": {
      "ticket": {
      },
      "legs": [
        {
          "departure_date": "2017-03-10",
          "carrier_code": "VX",
          "service_class": "J",
          "origin_city": "DUB",
          "destination_city": "ATL",
          "stopover_code": 1,
          "fare_basis_code": 0,
          "flight_number": ""
        }
      ]
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>authorize</transaction_type>
    <transaction_id>1915c52b28ff29edb12bc617ac102a03</transaction_id>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <card_holder>Travis Pastrana</card_holder>
    <card_number>4200000000000000</card_number>
    <cvv>834</cvv>
    <expiration_month>12</expiration_month>
    <expiration_year>2020</expiration_year>
    <travel>
      <ticket>
      </ticket>
      <legs>
        <leg>
          <departure_date>2017-03-10</departure_date>
          <carrier_code>VX</carrier_code>
          <service_class>J</service_class>
          <origin_city>DUB</origin_city>
          <destination_city>ATL</destination_city>
          <stopover_code>1</stopover_code>
          <fare_basis_code>0</fare_basis_code>
          <flight_number></flight_number>
        </leg>
      </legs>
    </travel>
  </payment_transaction>'

    Example Partial Capture

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Capture');
$request = $genesis->request();

$request
  ->setTransactionId('7fcc6097153beeec1dd1e71f643198d8')
  ->setRemoteIp('245.253.2.12')
  ->setAmount('100')
  ->setCurrency('USD')
  ->setReferenceId('1f2ee425e7c3159c60743098071771eb')
  ->setTravel('{"ticket"=>{"ticket_number"=>12345678123456, "passenger_name"=>"Passenger 01", "customer_code"=>"", "restricted_ticket_indicator"=>0, "agency_name"=>"New Agency", "agency_code"=>"AGN001"}, "legs"=>[]}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.CaptureRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;
import java.math.BigDecimal;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    CaptureRequest request = new CaptureRequest();

    request.setTransactionId("7fcc6097153beeec1dd1e71f643198d8");
    request.setRemoteIp("245.253.2.12");
    request.setAmount(new BigDecimal(100));
    request.setCurrency("USD");
    request.setReferenceId("1f2ee425e7c3159c60743098071771eb");
    request.setTravel("{"ticket"=>{"ticket_number"=>12345678123456, "passenger_name"=>"Passenger 01", "customer_code"=>"", "restricted_ticket_indicator"=>0, "agency_name"=>"New Agency", "agency_code"=>"AGN001"}, "legs"=>[]}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.capture(
  {
    "transaction_id": "7fcc6097153beeec1dd1e71f643198d8",
    "remote_ip": "245.253.2.12",
    "amount": "100",
    "currency": "USD",
    "reference_id": "1f2ee425e7c3159c60743098071771eb",
    "travel": {
      "ticket": {
        "ticket_number": 12345678123456,
        "passenger_name": "Passenger 01",
        "customer_code": "",
        "restricted_ticket_indicator": 0,
        "agency_name": "New Agency",
        "agency_code": "AGN001"
      },
      "legs": [

      ]
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <transaction_type>capture</transaction_type>
    <transaction_id>7fcc6097153beeec1dd1e71f643198d8</transaction_id>
    <remote_ip>245.253.2.12</remote_ip>
    <amount>100</amount>
    <currency>USD</currency>
    <reference_id>1f2ee425e7c3159c60743098071771eb</reference_id>
    <travel>
      <ticket>
        <ticket_number>12345678123456</ticket_number>
        <passenger_name>Passenger 01</passenger_name>
        <customer_code></customer_code>
        <restricted_ticket_indicator>0</restricted_ticket_indicator>
        <agency_name>New Agency</agency_name>
        <agency_code>AGN001</agency_code>
      </ticket>
      <legs/>
    </travel>
  </payment_transaction>'

    Visa Refund

    Visa Refund

    Request

    <?php

// Load the pre-configured ini file...
\Genesis\Config::loadSettings('/path/to/config.ini');

$genesis = new Genesis('Financial\Refund');
$request = $genesis->request();

$request
  ->set...('')
  ->setTravel('{"ticket"=>{"credit_reason_indicator_1"=>"C", "credit_reason_indicator_2"=>"A", "ticket_change_indicator"=>"B"}}');

try {
    $genesis->execute();
    $response = $genesis->response()->getResponseObject();
} catch (\Exception $e) {
    $response = $e->getMessage();
}

    import com.emerchantpay.gateway.GenesisClient;
import com.emerchantpay.gateway.api.TransactionResult;
import com.emerchantpay.gateway.api.constants.Endpoints;
import com.emerchantpay.gateway.api.constants.Environments;
import com.emerchantpay.gateway.api.requests.financial.RefundRequest;
import com.emerchantpay.gateway.model.Transaction;
import com.emerchantpay.gateway.util.Configuration;
import com.emerchantpay.gateway.util.Country;
import com.emerchantpay.gateway.util.Currency;

public class GenesisExample {
  public static void main()  {

    // Create configuration
    Configuration configuration = new Configuration(Environments.STAGING, Endpoints.EMERCHANTPAY);

    configuration.setUsername("SET_YOUR_USERNAME");
    configuration.setPassword("SET_YOUR_PASSWORD");
    configuration.setToken("SET_YOUR_TOKEN");

    RefundRequest request = new RefundRequest();

    request.set...("");
    request.setTravel("{"ticket"=>{"credit_reason_indicator_1"=>"C", "credit_reason_indicator_2"=>"A", "ticket_change_indicator"=>"B"}}");

    GenesisClient client = new GenesisClient(configuration, request);
    client.execute();

    // Parse Payment result
    System.out.println(client.getResponse());

  }
}

    var genesis = require('genesis.js/lib/genesis.js');
var transaction = new genesis.transaction();

var failure = function(reason) {
  return console.log(reason);
};

var success = function(data) {
  return console.log(data);
};

transaction.refund(
  {
    "...": "",
    "travel": {
      "ticket": {
        "credit_reason_indicator_1": "C",
        "credit_reason_indicator_2": "A",
        "ticket_change_indicator": "B"
      }
    }
  }
).send()
  .then(success)
  .catch(failure);

    curl https://username:password@staging.gate.e-comprocessing.net/process/TERMINAL-TOKEN \
   -X POST \
   -H "Content-Type: text/xml" \
   -d '
  <?xml version="1.0" encoding="UTF-8"?>
  <payment_transaction>
    <...></...>
    <travel>
      <ticket>
        <credit_reason_indicator_1>C</credit_reason_indicator_1>
        <credit_reason_indicator_2>A</credit_reason_indicator_2>
        <ticket_change_indicator>B</ticket_change_indicator>
      </ticket>
    </travel>
  </payment_transaction>'

    Request Parameters

    Parameter Required Format Description
    travel optional
       ticket optional
          credit_reason_indicator_1 optional String(1) This field indicates the reason for a credit to the cardholder. Allowed values: A, B, P, O
          credit_reason_indicator_2 optional String(1) This field indicates the reason for a credit to the cardholder. Allowed values: A, B, P, O
          ticket_change_indicator optional String(1) This field will contain either a space or a code to indicate why a ticket was changed. Allowed values: C, N

    required* = conditionally required

    Allowed Values

    Car Rental Classes

    Value Description
    1 Mini
    2 Subcompact
    3 Economy
    4 Compact
    5 Midsize
    6 Intermediate
    7 Standard
    8 Full size
    9 Luxury
    10 Premium
    11 Minivan
    12 12 passenger van
    13 Moving van
    14 15 passenger van
    15 Cargo van
    16 12 foot truck
    17 20 foot truck
    18 24 foot truck
    19 26 foot truck
    20 Moped
    21 Stretch limousine
    22 Regular limousine
    23 Unique limousine
    24 Exotic limousine
    25 Small/medium truck
    26 Large truck
    27 Small SUV
    28 Medium SUV
    29 Large SUV
    30 Exotic SUV
    9999 Miscellaneous

    Charge Types

    Value Description
    BF Bundled Service
    BG Baggage Fee
    CF Change Fee
    CG Cargo
    CO Carbon Offset
    FF Frequent Flyer
    GF Gift Card
    GT Ground Transport
    IE In-flight Entertainment
    LG Lounge
    MD Medical
    ML Meal / Beverage
    OT Other
    PA Passenger Assist Fee
    PT Pets
    SA Seat Fees
    SB Standby
    SF Service Fee
    ST Store
    TS Travel Service
    UN Unaccompanied Travel
    UP Upgrades
    WI Wi-Fi
    MISC Miscellaneous Airline Charges

    Car Rental Extra Charges

    Value Description
    1 Gas
    2 Extra Mileage
    3 Late Return
    4 1 Way Ser Fee
    5 Parking Violation

    Hotel Rental Extra Charges

    Value Description
    2 Restaurant
    3 Gift Shop
    4 Mini Bar
    5 Telephone
    6 Laundry
    7 Other

    Ticket Change Indicators

    Value Description
    C Change to existing Ticket
    N New ticket

    Credit Reason Indicators

    Value Description
    A Passenger Transport Ancillary Cancellation
    B Travel Ticket and Passenger Transport
    P Partial Refund of Travel Ticket
    O Other

    Genesis SCA Services

    General Info

    Genesis SCA(Strong Customer Authentication) Services provides the ability to check if a transaction is in the scope of SCA. The API is synchronous and is based on RESTFul practices. Be sure to set Content-type: application/json in your headers.

    To interact with the SCA API, you need to provide login credentials using standard HTTP Basic Authentication. (Credentials can be found in your Admin interface.)

    SCA Checker

    This call is used to check if SCA is required

    POST /v1/sca/checker/:terminal_token

    Request

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

    curl https://username:password@staging.gate.e-comprocessing.net/v1/sca/checker/:terminal_token \
   -X POST \
   -H "Content-Type: application/json" \
   -d '
  {
    "card_number": "4200000000000000",
    "moto": false,
    "mit": false,
    "recurring": false,
    "transaction_amount": 350000,
    "transaction_currency": "EUR",
    "transaction_exemption": ""
  }'

    Successful Response

    This request is not implemented yet

    This request is not implemented yet

    This request is not implemented yet

      [
    {
      "sca_required": "no",
      "sca_result_reason": "Issuer out of the EEA",
      "exemption": null
    }
  ]

    Request Parameters

    Parameter Required Format Description
    card_number required string(16) Complete cc number of customer.
    transaction_amount required number Amount of transaction in minor currency unit.
    transaction_currency required string(3) Transaction currency
    moto optional boolean Signifies whether a MOTO (mail order telephone order) transaction is performed.
    mit optional boolean Signifies whether a MIT (merchant initiated transaction) is performed.
    recurring optional boolean Signifies whether a Recurring Sale transaction is performed.
    transaction_exemption optional string(30) Exemption

    required* = conditionally required

    Successful Response Parameters

    Parameter Type Description
    sca_required number Sca Required. Possible values are yes, possible_exemption or no
    sca_result_reason string The reason for the returned SCA required
    exemption string Detected exemption
    cURL PHP Java Node.js